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PREFACE 


This is a new manual that describes the System Generation/ 32 
(Sysgen/32) program and the procedures to produce a 32-bit 
operating system. This manual is intended for system programmers 
and operators. 


Chapter 1 introduces the SYSGEN CSS procedure and describes its 
phases. Chapter 1 also explains how to load and start the 
Sysgen/3Z2 program. The Sysgen/32 commands that cause a 
configuration input file to be processed are described in detail. 
Chapter 2 details the sysgen configuration input statements that 
make up the input file. Chapter 3 lists and describes’ the 
libraries required by the Sysgen/32 program and explains how to 
tailor library modules to user needs and include the modified 
modules in the appropriate library. Chapter 4 details the 
OS/32-supported devices. Chapter 5 is written for the less 
experienced user and contains sample Sysgen/32 sessions. 


Appendix A compares the Sysgen/32 and the OS/32 configuration 
utility program (CUP) configuration statement defaults. Appendix 
B lists the sysgen messages, and Appendix C is a summary of the 
Sysgen/32 commands and configuration statements. Appendix D 
compares 0S/32 CUP and Sysgen/32 configuration statements. 


This manual applies to the CS/32 R06.1 software release and 
higher. The following manuals can be used in conjunction with 
this manual: 


MANUAL TITLE PUBLICATION 
NUMBER 
OS/32 Mini I/O System User Manual $29-485 
0S/32 Basic Data Communications Reference 
Manual $29-541 
OS/32 Copy User Guide $29-676 
OS/32 Link Reference Manual 48-005 


0S/32 System Macro Library Reference Manual 48-006 


OS/32 Edit User Guide 48-008 
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OS/32 Library Loader Reference Manual 48-020 
OS/32 System Planning and Configuration 

Guide 48-024 
OS/32 Operator Reference Manual 48-030 
0S/32 Application Level Programmer 

Reference Manual 48-039 
0S/32 Asynchronous Communications 

Reference Manual 48-047 
Common Assembly Language (CAL) Refierence 

Manual 48-050 
CAL Macro/32 Processor and Macro Library 

Utility Reference Manual 48-057 
32-Bit Systems User Documentation Summary 50-003 


For further information on the contents of all Perkin-Elmer 
32-bit 
Summarye 


viii 


manuals, see the 32-Bit Systems User Documentation 
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| CHAPTER 1 
INTRODUCTION TO SYSGEN/32 


1-1 INTRODUCTION 


Sysgen/32 is a program designed to enable a user to create and 
tailor an operating system to accomodate particular systems 
requirements. In Sysgen/32, hardware and software features for 
the operating system are selected and defined through the use of 
sysgen configuration statements. These statements are defined in 
a sysgen configuration input file. Driver and system modules 
provided in the OS/32 package are selected by Sysgen/32, based on 
the requirements indicated in these sysgen statements. 


The user can create a new configuration input file or modify an 
existing configuration input file using Sysgen/32 commands. The 
Sysgen/32 EDIT command enables the user to use all of the 0S/32 
EDIT command repertoire. The HELP command and the CONVERSATIONAL 
command are available to aid the user during the creation of a 
configuration input file. 


Once a configuration input file is created, it is processed by 
the Sysgen/32 program to produce macro callse These macros are 
subsequently expanded, assembled, and linked to yield an 
operating system. Figure 1-1 details the step-by-step process 
that results in the generation of an operating system using 
Sysgen/32. 
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Figure 1-1 Generation of an Operating System Using Sysgen/32 
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As shown in Figure 1-1, the system generation process involves 
four general steps: 


1. A configuration input file is created and processed via _ the 
Sysgen/32 program, resulting in a set of macro calls. 


2e The macro calls are expanded using CAL MACRO/32. 


3. The expanded macros are assembled using CAL/32, resulting in 
object modules. 


4, The object modules are linked using OS/32 LINK to yield an 
operating system. 


The user has the option to perform these steps in ae single 
process, by using a CSS procedure called SYSGEN, or in steps, by 
loading and executing each frogram in the overall procedure. 


1-2 CREATING AN OPERATING SYSTEM USING THE SYSGEN CSS 


The SYSGEN CSS can be used to create an operating system with 
minimal user interaction. The user creates the sysgen 
configuration input file and passes the filename and other 
optional parameters to the CSS. 


The macro generation, expansion, assembly, and linkage steps are 


performed automatically according to the SYSGEN CSS instructions. 
Figure 1-2 details the components of the SYSGEN CSS. 
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Figure 1-2 Generating an Operating System Using the SYSGEN CSS 


1-2-1 Starting the SYSGEN CSS 


The following format is used when starting the SYSGEN CSS. 


Formats 


SYSGEN input filename, [list filename], [segsize inc] 


library vol output vol 


,[print 


Parameters: 


input filename 


list filename 


segsize inc 


library volume 


output volume 


print filename 
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fi lenane] 


is the 1i- to 8-character name of the sysgen 
configuration input file. The CSS assumes a 
default extension of .SYS. If the file 
specified does not exist, an error message is 
generated and the CSS will abort. 


is the file descriptor of the list file to 
which all messages are written. If this 
parameter is omitted, a default file with the 
name (input filename) .LST, is allocated. 


is a decimal number specifying the number of 
kilobytes of additional memory available for 
use by the Sysgen/32 program. 


is a 1- to 4-character name (with colon) of 
the disk volume containing the libraries used 
by CAL MACRO/32 and LINK during CSS execution. 
If this parameter is omitted, the user volume 
is the default. 


is a 1- to 4-character name (with colon) of 
the disk volume where the newly created 
operating system will reside. If this 
parameter is omitted, the user volume is the 
default. 


is the file descriptor of the file that will 
contain the list output of the CAL/32 program 
if macro expansion is successfully completed, 
or of the CAL MACRO/32 program if macro 
expansion was not successfully completed. The 


contents of this file are useful as a 
debugging aid if macro expansion or assembly — 
results in an error. If this parameter is 


omitted, the CSS assigns output to the NULL 
device. 


Examples: 
SYSGEN CONFIG1, LIST1, 10, M300:, M301:, PRINT1 


This example initiates the SYSGEN CSS and passes the following 
information to the CSS: 


e cCONFIG1 is the configuration input file. An extension of .SYS 
is assumed by the CSS. 

e LIST1 is the list file for messages. 

e 10is the segment size increment. 


@ M300: is the library volume containing the libraries used by 
CAL MACRO/32 and LINK. 


@ M301: is the volume on which the new operating system will 
reside. 


e PRINT1 is the file that will contain the CAL MACRO/32 or 
CAL/32 list output for debugging purposes. 


Functional Details: 


If an error occurs during the execution of the SYSGEN CSS, an 
error message is written to the console and the CSS is aborted. 
If the CSS reaches a successful completion, the following 
information is displayed to the console: 


e The OSMAP filename = (input filename) .~LST or user-specified 
fa 

e The OS Object filename = (input filename) .OBJ 

e The OS Task filename = (cutput velume name + input filename) 
OS 

1.2.2 Components of the SYSGEN CSS 


The SYSGEN CSS is comprised of three CSS modules: 


@ SYSGEN32 CSS, 
@e SYSMACRC CSS, and 


e SYSLINK CSS. 
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These modules can be run independently, outside of the SYSGEN CSS 
procedure. However, when they are executed independently, the 
user must pass the appropriate parameters to each CSS. It is 
particularly useful to be able to execute the SYSLINK CSS routine 
independently, since this enables a previously linked OS to be 
relinked to incorporate changes in system and driver library 
modules. The following sections detail the procedures for 
executing the SYSGEN32, SYSMACRO, and SYSLINK CSS routines 
independently. 


1.262¢1 Executing the SYSGEN 32 CSS 


The SYSGEN32 CSS executes the Sysgen/32 program which processes 
the sysgen configuration input file and generates macro calls. 


Formats 


SYSGEN32 input filename ,[list filename],[segsize increment] 
Parameters: 


input filename is the 1- to 8-character name of the sysgen 
configuration input file. The CSS routine 
assumes an extension of .SYS. If the file 
specified does not exist, an error messge is 
generated and the CSS aborts. 


list filename is the file descriptor of the list file to 
which messages are written. If this parameter 
is omitted, a list file (input filename .LST) 
is allocated. 


segsize is a decimal number specifying the Rhumber of 
increment kilobytes of additional memory available for 
use by the Sysgen/32 program. 


Functional Details: 

If the CSS encounters an error while executing (end of task code 
other than 0), an error message is generated and the CSS will 
abort. The list file should be checked for errorse If the CSS 
reaches a successful comrletion (end of task code = 0), the file 


containing the macro calls generated by the Sysgen/32 program 
will be contained in a file named: 


(input filename). MAC 


This file is used by the next CSS procedure, SYSMACRO. 
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122-2-2 Executing the SYSMACRO CSS 


The SYSMACRO CSS takes the macro calls generated by the Sysgen/32 


program, expands them using MACRO/32, and assembles the 


source modules using CAL/32. 


Formats: 


library volume 


SYSMACRO macro output filename, 


» [print filename] 


Parameters: 


macro output is the 1- to 8-character name 
generated 
assumes an 


filename containing the macro calls 
Sysgen/3z program. The 


the 


expanded 


file 
by the 


extension of .eMAC. If the specified file does 


not exist, an error message is 


the CSS will abort. 


library volume is the name (colon included) 


generated and 


the disk 


volume containing the libraries used by CAL 


MACRO/32 during CSS execution. 


Tf 


this 


parameter is omitted, the user volume is the 


default. 


print filename is the 1- to 8-character name of the file that 


will contain the list output 


MACRO/32 or CAL/32 programs. 


Functional Details: 


If the CSS encounters an error (end of task code other 
an error message is generated and the CSS will abort. 


If the CSS reaches a successful completion (end of 


the CAL 
then Oy 
code = 


0), the object module assembled by CAL/32 will be contained in a 


file nameds 


(macro output filename).OBJ 


This file will be used by the next CSS routine, 


162¢2-3 Executing the SYSLINK CSS 


The SYSLINK CSS takes the object modules 


assembled 


SYSLINK CSS. 


in the 


SYEMACRO CSS and links the object with the appropriate libraries 


to produce an operating system. 
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Formats: 


Parameters: 
object is the 1- to 8-character name of the file 
filename containing the CAL produced object code 


generated during the SYSMACRO CSS. I£f the 
specified file does not exist, an error 
message is generated and the CSS is aborted. 


map filename is the file descriptor of a file to which the 
OS map is appended. If this parameter is 
omitted, the CSS will append the map to a file 
called (cal object filename) .LST, allocating 
it if necessary. 


library volume is the name (colon includei) of the volume 
where the system and driver libraries reside. 
If this parameter is omitted, the user volume 
is the default. 

output volume is the name (colan included) of the disk 
volume where the newly created OS will reside. 


Functional Details: 


If an error occurs during execution of the SYSLINK CSS (end of 
task code other than 0), an error message is generated and the 
CSS is aborted. 
Tf this CSS reaches a successful completion, the following 
information is displayed: 

OSMAP file = (object filename).LST or a user-Specified fd 

OS object file = (object filename).OBJ 


OS Task file = (output volume name + object filename).OS 
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1.3 USING THE SYSGEN/32 PROGRAM 


The Sysgen/32 program enables a user to create and/or process a 
sysgen configuration input file to generate macro calls. The 
option to process a previcusly generated configuration input file 
or interactively create and process a new configuration input 
file is available. 


The Sysgen/32 program runs in batch and interactive environments. 
In a batch environment, the program processes the configuration 
input file without user interaction. In an interactive 
environment, the user can create the configuration input file 
directly from the command device and correct run time errors as 
they occur. 


1.3.1 Loading and Starting the Sysgen/32 Program 


The following commands are used to load and start the Sysgen/32 
program. 


1e3et01 LOAD Command 


The system LOAD command loads Sysgen/32 into memory. 


Format: 


LOAD SYSGEN32 [psegsizé] 


Functional Details: 


segsize 
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is an optional parameter that specifies the 
segment size increment. This increment must 
be large enough to accommodate processing of 
all the configured devices. 


If the segsize is not large enough, the 
message: 


LINE ADDR STACK OVERFLOW 


TASK PAUSED 


will be displayed. The task should then be 
cancelled and reloaded with a larger 
increment. 


163-122 START Command 


The system START command begins execution of the Sysgen/32 
program. All parameters are optional. The INPUT and OUTPUT 
parameters specify the configuration input file and the macro 
output file, respectively. The LIST parameter specifies the list 
device or file. The COMMAND parameter specifies the command 
input device and establishes whether the Sysgen/32 program will 
execute in a batch or interactive environment. . 


Formats 
START [, LNPUT=£d 1)[,QUTPUT=f4d 2)[, com MAND=f£d 3|[-LIST=f4 u] 
Parameters: 


INEUT= fd; specifies the configuration input file to 
be processed by the Sysgen/32 programe 


OUTPUT= fd, specifies the output file to which macro 
calls generated by Sysgen/32 will be written. 
The output file cannot be an existing file. 


COMMAND= fd3 specifies the command input device. This 
parameter establishes whether the environment 
is batch or interactive. [Tf an interactive 
device is specified, the environment is 
interactive. CON: is the default for a 
command device. 


LIST= fdy specifies the device or file to which all 
list output and messages generated during 
sysgen execution are sent. If the list 


parameter specifies a file, the file must 
already existe PR: is the default list 
device, 


Functional Details: 


If the START command is entered with both INPUT and OUTPUT 
parameters specified and the command device is omitted, the 
Sysgen/32 program will immediately process the configuration 
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input file and assume a batch envirecnment unless the input file 
is empty. Tf the specified input file is empty, the program will 
display the following message: 


READY FOR CONFIGURATICN INPUT 


The program then waits for the user to interactively input 
configuration input statements that will be used to create the 
configuration input file. 


If the START command is entered without the INPUT and OUTPUT 
parameters, the Sysgen/32 commands described in the following 
sections can be used to: create a sysgen input file in a 
conversational mode (CONVERSATIONAL), specify the configuration 
input file (INPUT), spvnecify the macro output file (OUTPUT), 
modify the sysgen configuration input file (EDIT), and initiate 
processing of the sysgen configuration input file (PROCESS). The 
HFLP command is also availaktle as a user aid. 


104 SYSGEN/32 COMMANDS 


The following Sysgen/32 commands are available: 


@ INPUT 

e CUTPUT 
@ PROCESS 
e® EDIT 


@e CONVERSATICNAL 


e HELP 
e FAUSE 


@e END 
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1e4-21 INPUT Command 


The INPUT command specifies a configuration input file to be used 
as input to the Sysgen/32 programe This command is used if the 
INPUT parameter was not specified with the START command. 


Formats: 
INFUT fd 
Parameter: 
fd is the file descriptor of a configuration 
input file to be processed by the Sysgen/32 
program. 


Functional Details: 


If the specified input file is empty, and the command device is 
an interactive device, the input file can be created either by 
entering configuration statements directly from the command 
device after the PROCESS command is entered, or conversationally. 
See Section 1.4.5. 
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1-4.2 OUTPUT Command 


The CUTPUT command specifies an output file to receive the macro 
calls generated by Sysgen/32. This command is used if the OUTPUT 
parameter was not specified with the START command. 


Formats: 


QUTPUT fa 


Parameters: 


fd is the file descriptor of the file that 
receives the Sysgen/32-generated macro calls. 


Functional Details: 


If the OUTPUT commard is entered with the name of an existing 
file, an error is generatede 
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1.4.3 PROCESS Command 


The PROCESS command initiates processing of the sysgen 
configuration input file. 
Format: 

EROCESS 


Functional Details: 


The PRCCESS command is not used if both a nonempty input file and 
an output file are specified as parameters of the START command 
but no command device is entered. 


1.4.4 EDIT Command 


The EDIT command makes the entire 0S/32 Edit command repertoire 
available to the user. This command is available during program 
execution in interactive mode only. 


Format: 
EDIT 
Functional Details: 


All of the OS/32 Fdit commands can be used to correct or modify 
the configuration input file. When the changes are made and the 
file is saved, the END or DONE command terminates the edit 
session and returns control to the Sysgen/32 program. 


Examples 
>INPUT SYS1e-SYS specify input and output 
>OUTPUT SYS1.MAC files 
>PROCESS 
ILLEGAL VALUE 3280 aaa encountered 
READY FOR SYSGEN COMMANDS sysgen program enters command 


input mode 


>EDIT 
READY FOR EDIT COMMANDS 
>GET SY¥S1.SYS 


>OPT LIST=CON: enter edit mode and correct 
>T/3280/ error 

2 CFU 3280 

>SU/3280/3230/ 

>DONE 


WORKFILE = FIXD:SYS1.000 

RENUMBERED INPUT FILE AVAILASLE FIXD:SYS1.SYS 

>READY FOR SYSGEN COMMANDS presine Sysgen/32 processing 
>PROCESS 
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| CONVERSATIONAL | 


124.5 CONVERSATIONAL Command 


The CONVERSATIONAL command initiates a sysgen prompt and user 
response session in an interactive environment. This prompt and 
respense session is a user aid in creating a configuration input 
file. 


Format: 


CONVERSATIONAL 


Functional Details: 


The Sysgen/32 program issues interactive prompts relating to the 
hardware configuration and software options. The possible 
responses, in parentheses, and the defaults, in brackets, are 
disrlayed after each prompt where applicable. Defaults are taken 
if CR is depressed for all but device prompts. A response must 
be entered for all device prompts. 


The program will create sysgen configuration statements based on 
the responses to the fgroempts. Acceptable statements will be 
written to the specified input file. Nonacceptable statements or 
responses will cause the program to generate an error message and 
to reissue the appropriate prompt or prompts until an acceptable 
respense is generated. 


If the CONVERSATIONAL command is entered before an input file was 
defined via the INPUT command or INPUT parameter of the START 
command, the following message is displayed: 


INPUT MUST BE ENTERED 


When in CONVERSATIONAL mode the user can access the Help file by 
entering a question mark (7?) in response to a prompt. The 
question mark causes the Help file to display pertinent 
information about a configuration statement or parameter, and 
briefly describes its use. The progran then reissues the prompt 
sequence for the configuration statement. After all prompts have 
been issued, the following message is displayed: 


CONVERSATIONAL PROCESSING COMPLETE 
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The PROCESS command can then be entered to start processing of 
the newly created input file. Certain errors will not be 
detected during the conversational session, but will be detected 
in the processing phasee These errors can be corrected using the 
EDIT command. See Section 1-5e4. 


Examples 


PROCESSCR MODEL (7/32, 8/32,3210, 3220, 3230, 3240,3250) [3220] 
>? 
CPUs SPECIFIES THE 32-BIT PROCESSOR MODEL. 


COMMAND FORMAT: CPU [N][,R] 


N IS THE MODEL NUMBER OF THE PROCESSOR. 


THE VALUE FOR N MAY BE: 
7/32, 8/32, 3219, 3220, 3230, 3240, 
32506 


R SPECIFIES THE NUMBER OF REGISTER SETS, 
2 CR 8. 


THE CEFAULT VALUES FOR TH CPU COMMAND ARE 
3220 WITH 8 REGISTER SETS. 
PROCESSOR MODEL (7/32,8/32,3210, 3220, 3230, 3240,3250) [3220] 
>CR 
NUMBER OF REGISTER SETS (2 OR 8) [8] 
>CR 
O/S VERSICN (8 CHAR. ALPHANUMERIC STRING) [BLANKS] 
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124.6 HELP Command 


The HELP command accesses the Help file and displays sysgen 
commands and configuration statements with a brief description of 


each and how to use it. 


Format: 


Parameters: 


hame specifies the name of a specific sysgen 
statement or command to be displayed. 


* specifies that all sysgen statements and 
commands be displayed. 


Functional Details: 


If the HELP command is entered Without a parameter, the following 
message is displayed: 


FOR A LIST OF COMMANDS TYPE HELP * 
FOR HELP ON ANY COMMAND MNEMONIC, TYPE HELP MNEMONIC 
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Example 1:3: 


PHELP * 
I(NPUT) 
FACUSE) 

BC ACKGROUND) 
CS(S) 
DIR(CECTORY ) 
FRRORR( EC) 
INTC ERCEPT ) 
MAXC(TASK) 
MOC DULE) 
PCOLL) 
TC(OM) 


COOR(DINATION) 
FOR HELP CN ANY OF THE ABCVE CCMMAND MNEMONICS, 


HELP* 


Example 2:3 


PHELP ACC 


OCUTPUT) 
PR(OCESS) 
CL(OCK ) 
DA(TF) 
DI(SCBLOCK ) 
F(LOAT) 
ITCAM) 
MCONF(IG) 
NOSE(G) 
SPC(OOL) 
TEC MP) 
COPY 


CONVCERSATIONAL) 
END 
CMC(CLEN) 
DEVACDS) 
DSCYS) 
ICC(LASS) 
JC(OURNAL) 
MEMCHECK 
TGC(D) 
STCARTUP) 
VER(SION) 


ACCOUNTING: INCLUDES ACCOUNTING SUPPORT. 


COMMAND FORMAT: 


N = 


ACCCUNTING [{N}} 


DECIMAL VALUE FROM 2 THROUGH 32, 
THE MAXIMUM NUMBER OF ACCOUNTING CLASSES. 
DEFAULT FOR N 


We 


ED(IT) 
ACCC OUNTING) 
CP(U) 
DEVICCES) 
ENDC 

IL( EVEL) 
LCOGLEN) 
MECMORY) 
QUCEUE) 
SST CABLE) 
V(OLUME) 


TYPE HELP MNEMONIC 


{,NOFILE ACCOUNTING] 


SPECIFYING 


NO FILE ACCOUNTING SPECIFIES THAT FILE ACCOUNTING 


SUPPORT IS EXCLUCED. 
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1-4-7 PAUSE Command 


The PAUSE command pauses execution of the Sysgen/32 program and 


returns control to the operating system. 


Format: 


PAUSE 
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124.8 END Command 


The END command ends the Sysgen/32 program. 


Formats: 


END 


Functional Details: 


An end of task code other 
occurred during Sysgen/32 
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than zero indicates that an 
execution in a batch environment. 


error 


| CHAPTER 2 
SYSGEN/32 CONFIGURATION STATEMENTS 


2-1 INTRODUCTION 


Sysgen configuration statements make up the configuration input 
file that defines the hardware and software features of the 
target operating system. This chapter presents a detailed 
aescription of each configuration statement under its respective 
heading. The sysgen configuration statements are: 


ACCOUNTING DSYS MEMORY 
BACKGROUND ENDC MODULE..eENDM 
CLOCK ERRORREC NOSEG 

CMDLEN FLOAT QUEUE 
COORDINATION ILEVEL ROLL 

COPYee eENDCOPY INTERCEPT SPOOL 

CPU TOCLASS SSTABLE 

Css ITAM STARTUP.»eENDS 
DATE JOURNAL —  TCOM 

DEVADS LOGLEN TEMP 
LEVICES..- ENDD MAXTASK TGD 

DIRECTORY MCONFIG VERSION 
DISCBLOCK MEMCHECK VOLUME 


Certain statements may span more than one line. A comma as the 
last nonblank character indicates that the statement is continued 
on the next line. 


Any characters following an asterisk (*) are treated as comments. 


If an asterisk is in column 1, the entire line is treated as a 
comment linee Comment lines are copied to the list device. 
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2e1-1 ACCOUNTING Statement 


The ACCOUNTING statement specifies that accounting support is 
included in the system. 


Format: 


ACCOUNTING [=] [-NCFILEACCOUNTING ] 


Parameters: 


nn is a decimal number from 2 through 32 
specifying the maximum number of device or 
file classes to be supported by the accounting 
facility. The minimum number of classes must 
be 2, because indexed and contiguous files 
always need two classes. If this parameter is 
omitted, 4 is the default. 


NOFILEACCOUNTING 


prevents logging of accounting data when files 
are deleted or renamed. 


Functional Details: 


Fach device or file class supported by the accounting facility 
must be defined by the IOCLASS statement. Fach I/0 class 
supported by the accounting facility occupies 12 bytes in the 
user task control block (TCB) and 4 bytes in the multi-terminal 
monitor (MTM) for each MTM user of the accounting facility. If 
the ACCOUNTING statement is omitted, accounting support is not 


included in the system. 


See the IOCLASS statement or J[IOCLASS parameter of the device 
statement for file or device classes. 


The NOFILEACCOUNTING opticn allows the user to reduce the size of 
the account transaction file (ATF). 
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2e1e-2 BACKGROUND Statement 


The BACKGRCUND statement establishes the maximum priority and 


maximum amount of 
system. 
Format: 

BACKGRCUND [=] 
Parameters: 


maxpriority 


maxsize 


Functional Details: 


‘system space for a background task in the 


Maxpriority maxsize 


is a decimal value from. 11 through 248 
specifying the highest priority at which a 
background task can rune If this parameter is 
omitted, 16 is the default. 


is a decimal value in increments of 0.25kb 
specifying the largest system space area in 
which system data structures; i.e@e, file 
control block (FCB), task queve entry (TQE), 
task control block (TCB), of a background task 
can be stored. If this parameter is omitted, 
9 is the default. 


If this statement is omitted, the default parameters are assumed. 
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2e1-3 CLOCK Statement 


The CLOCK statement sets the line frequency of the clock and 


device addresses 


of both the precision interval clock (PIC) and 


line frequency clock (LFC) for the system. Together, these 
clocks are called the universal clock module. 


Formats 


Chock [=] 


Parameters: | 


50 


pic addr 


1fc addr 


Functional Details: 


pic addr lfc addr 
f ’ [,D] 


is a hexadecimal number indicating the line 
frequency value. If this parameter is 
omitted, 60 is the default. 


is a hexadecimal number specifying the 
physical device address of the PIC. The 
user-specified address must not be greater 
than the maximum device address specified by 
the DEVACTS statement. If this parameter is 
omitted, 6C is the default. 


is a hexadecimal number specifying the 
physical device address of the LFC. The 
user-specified address must not be greater 
than the maximum device address specified by 
the DEVALS statement. If this parameter is 
omitted, 6D is the default. 


is the alphabetic character D specifying that 
the date and time are to be displayed on the 
display panel. This parameter should be 
specified only if the CPU statement indicates 
that the target system is a Perkin-Elmer Model 
7/32 or 8/32 processor. 


If this statement is omitted, the default parameters are assumed. 
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CMDLEN 
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201-4 CMDLEN Statement 


The command buffer length (CMDLEN) statement specifies the 
maximum length of the system command buffer or buffers if command 
substitution system (CSS) is supported in the system. 


Formats: 
n 
CMDLEN [=]| | 
BO 
Parameters: 
n is a decimal number from 32 through 1024 
specifying the number of bytes in the system's 
command buffers. If this parameter is 


omitted, 80 is the default. 


Functional Details: 


If CSS is supported, or commands are read from devices or files 
with record lengths greater than 80, a larger command buffer 
length must be specified. If CSS is supported, parameter 
substitution causes a small input line length to be expanded to 
a greater length which must be less than or equal to the system 
command buffer length. 


If this statement is omitted, 80 is the default. 
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201-5 COORDINATION Statement 


The COORDINATION statement eStablishes the maximum number of 
Simultaneous data transfers allowed on the specified selector 
channels (SELCH). This statement must be entered if the number 
of SELCHs is greater than the number of simultaneous data 
transfers allowed in the target system. 


Format: 
Sy 
SELCH = 
(S4-S20Sn) *CLRANSFER=n 
COORDINATION [=] name, 
*DEVICE = 
(name,,eee,name, ) 
Parameters: 
SELCH= Si75n specifies the SELCH to be coordinated. 
DEVICE= namei-namen specifies the devices requiring 


coordination. 


TRANSFER= n specifies the maximum number of simultaneous 
transfers. If 1is specified, the resulting 
extended direct memory access (EDMA) node 
functions in away Similar to a supernode, 
providing coordination only, without impact on 


the transfer rate. Table 2-1 provides 
recommended numbers of simultaneous transfers 
for the variaus Perkin-Elmer 32-bit 
procesSsorse 
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TABLE 2-1 RECOMMENDED NUMBER OF SIMULTANEOUS DMA TRANSFERS 
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| NUMBER OF TRANSFERS {| SYSTEM 

; 1 } 7/32 { 

jancnenrestteatesere eer s-< ee Ran ap as phdisa at neared | 
1 8/32 (with one or more nonbuffered 


{ | 
| selector channels (ESELCH)). { 
| | 
| | 


8/32 (with buffered selector channels 
(BSELCH)) 
|o------- won nn nn ene === wan 2--- -------------------------- l 
} 4 { 3210, 3220, 3230 (with buffered | 
{ | selector channels (BSELCH)) { 
Ee eg nr Ge ee ee a ay ng hee eee ee pe a a ee | 
| * | 3240, 3250 l 
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Functional Details: 


The COCRDINATION statement should be used if the number of SELCHS 
in a system with MSM80 or 4SM300 disks or 6250bpi magnetic tape 
drives is greater than the number of simultaneous data transfers 
allowed in the system. 


One COORDINATION statement must be entered for every group of 
SELCHs or devices requiring coordination. 
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2-1-6 COPY Statement 
The COPY statement copies data into the macro output file. 


Statements are copied to the file in the format in which they are 
read until the ENDCOPY statement is encountered in column 1. 


Formats: 


COPY 
line, 


line, 


ENDCOPY 


Parameters 


line | specifies data to be copied into the macro 
output file. 


Functional Details: 


The COPY statement is useful when a user wants to include 
user-specified macros in the generated macro file. 
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2e1-7 CPU Statement 


The central 
Perkin-Elmer 
configured. 


Formats: 


Parameters? 


3250 
3240 
3230 
3220 
3210 
8/32 
7/32 


2 
8 


Functional Details: 


processing unit (CPU) statement specifies the 
32-bit processor for which the system is being 


specify the target system processor model 
number. If this parameter is omitted, 3220 is 
the default. 


specify the number of register sets supported 
by the hardware. The Perkin-Elmer Model 3210, 
3220, 3220, 3240, 3250, or 8/32 support 8 
register setSe If this parameter is omitted 
for the Model 7/32 processor, 2 is the 
default. If this parameter is omitted for all 
other processors, 8 is the default. 


If this statement is omitted, the default parameters are assumed. 
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2-1-8 CSS Statement 


The command substitution systen 


(css ) 


statement 


specifies the 


maximum number of nested CSS calls allowed in one routine for the 


target system. 


Formats 


Parameters: 


n is a decimal 
the 


specifying 


calls in one 

routines that 
CSS is not supported, 
this parameter is omitted, 


Functional Details: 


The operating system allocates the amount of 
a CSS by the following equation: 


MEMORY = CMDLEN n x CSS n 


number from 


maximum 


routine: ieee, 
can be active at one time. If 
1 must be specified. If 


Tf this statement is omitted, the default is 5. 


through 249 


number of nested CSS 
the number of 


5 is the default. 


memory required for 
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21-9 DATE Statement 
The DATE statement specifies the format in which the current date 


is expressed for the system. 


Formats: 


pate [=] {ei 


Parameters: 


DDMMYY is day-month-year formate 


MMUDYY is month-~day-~year format. If this parameter 
is omitted, MMDDYY is the default. 
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2-12-10 DEVADS Statement 


The device address (DEVADS) statement specifies the maximum 
number of devices, maximum device address, maximum number of 
bytes occupied by the interrupt service pointer (ISP) table, and 
the starting address of the memory acccess controller (MAC) or 
SSTABLE in the system. 


Formats: 


Parameters: 


3 are decimal numbers specifying a table entry 
1 containing established maximum values. If 
0 this parameter is not specified, 0 is the 

default. The established values specified in 


the DEVALS statement must correspond to the 
hardware configuration. Table 2-2 lists the 
maximum values associated with each DEVADS 
statement. 


TABLE 2-2 DEVADS STATEMENT VALUES 


| | { | | MAC,MAT, | 
| | | MAXIMUM | NUMBER OF|{ OR SST | 
| ENTRY | NUMBER OF | DEVICE | BYTES IN | STARTING | 
1 NUMBER {| DEVICES | ADDRESS | ISP | ADDRESS | 
| =— SSS SSS SSS SSS SSS SS SSS Se SSeS SS SSS SSHSssssSssSsecssa==a| 
j 3 | 1023 | X°3FF* { 2048 } x*900° { 
Ste Fer Sees ose eee re ress Seer eee PS ses ae eos ee | 
| 1 1 511 {| X'1FF* | 1024 f x*500' | 
[Ses S SPSS See Sears See Ser eae ea See ses Sse a Ssse > | 
| 9 ( 255 | X"°OFF* {| 512 { x*300° { 
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| DEVICES...ENDD | 


Ze1-11 DEVICES-e-eeENDD Statements 

The DEVICES...-®NDD statements are used to delimit the device 
descriptor statements. Every device to be configured in the 
target system must be defined by a device descriptor statement. 
Each device descriptor statement requires three parameters, the 
device name specification, the device address, and the device 
code. These three parameters must be entered in the order 
described. Optional parameters describing other device details 


can be entered in any order. 


Formats: 


DEVICES | 

dev name: ,address,dcod [,CONSOLE,] [,LoCLASS=n] [-/ILEVEL=n] 
[-SELCH=n] [,CONTROLLER=n] [- NONSHARED] (-SPINDLE=n | 
[-XDCOD=xdcod] [, Eov] [-QUEUE=name] [,RECLEN=n] [,SLZE=n] 
[>TRANSLATE=name] [,REALCONTROL=n] [, WRITECONTROL=n] 


[-PADCOUNT=n] [,LEADCCUNT=n] [,FOLLIMIT=n] [,DuaL] 


XA 
eCLOCK=) XB 
XC 
XD 
ENDD 
Parameters: 
dev name is a  1- to 4-character device mnemonic 
specifying a unique device name. The first 
character must be alphabetic, the remaining 
characters alphanumeric. 
address is a hexadecimal number specifying the 


Physical address of a device. This number 
must not be greater than the maximum device 
address specified in the DEVADS statement. 
For pseudo devices, specify 0. 
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dcod 


CONSOLE 


IOCLASS= 


ILEVEL= 


SELCH= 
CCONTROLLER= 
NONSHARED 
SPINDLE= 


XDCOD= 


EOV 


QUEUE= 


RECLEN= 


SIZE= 


is a decimal number ranging from 16 through 
254 specifying the device code. For pseudo 
devices, specify 1. 


identifies the device as the console device. 


nis a decimal number from 0 through 31 
specifying the I/0 class of each individual 
device. This number must not be greater than 
the maximum number of device or file classes 
specified in the ACCOUNTING statement. If 
this parameter is omitted, the global IOCLASS 
is assumed. 


hn is a decimal number from 0 through 3 
specifying the hardware interrupt level of 
each individual device. If this parameter is 
omitted, the global interrupt level (see the 
ILEVEL statement) is assumed for this device. 


nis a 2-digit hexadecimal number specifying 
the selector channel address. 


n is a 2-digit hexadecimal number specifying 
the disk controller address. 


specifies that an existing shared-busy 
conflict for this device should be ignored. 


n is a decimal number from OO through 3 
specifying the floppy disk spindle number. 


xdcod is a decimal or hexadecimal halfword 
used to specify additional configuration 
information within a device. If a hexadecimal 
value is specified, it must be preceded by an 
xX: 


XO0040 


indicates that end of volume (EOV) labels on 
Magnetic tapes be processed. If EOV is not 
specified, EOV labels are not supported. 


Mame is a 1- to 8=character alphanumeric 
string indicating the name of an alternate 
disk I/O scheduling routine. 


n specifies the physical record length of a 
device. 


mn specifies the page size for pseudo devices. 
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TRANSLATE= name specifies a i- to 8-character 
alphanumeric name of the translation table 
used for this device. 


*READCONTROL= n is a hexadecimal mask specifying the read 
control charactere The value must be preceded 
by an X. 


*WRITECONTROL= n is a hexadecimal mask specifying the write 
control charactere The value must be preceded 


by an X. 
*PADCOUNT= =n is a decimal number specifying the length of 
a pad sequence within a unit of data. 
*LEADCOUNT= n is a decimal number specifying the number of 
leading synchronous characters within a unit 
of data. 
*POLLIMIT= nis a decimal number specifying the limit of 
polling retries allowed on a line. 
DUAL specifies that dual port option is in effect 
for MSM disks. 
CLOCK= XA specifies the A clock 
XB specifies the B clock 
XC specifies the C clock 
X¥D specifies the D clock 
NOTE 
The asterisk (*) denotes parameters 


applicable to ITAM devices only. 


Functional Details: 


Device codes and device addresses determine shared-busy conflicts 
between devices, such as fixed and removable disks in the same 
drive, cassettes, and TTY/KE with TTY/RP on the same device. The 
shared-busy conflicts can be overridden by the NONSHARED 
parameter. Only one channel control block (CCB) is created for 
disks with a shared-busy conflict. 


If ILEVEL and IOCLASS statements precede a group of devices, they 
remain in effect until another ILEVEL or IOCLASS statement is 
read. The ILEVEL and IOCLASS parameters in the device statement 
can be used to override the global setting specified in the 
global ILEVEL or IOCLASS statement for a specific device. 
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Default values for all standard devices supported by Sysgen/32 
are maintained in the Sysgen/32 Macro Library. These defaults 
represent driver initialization and termination routines, disk 
Sizes, device attributes, defaults for communications devices, 
etc. Certain defaults can be overridden by entering the 
appropriate parameter in the device statements. 


261-1121 Coding Examples of Device Statements 
Tne following examples show the coding of the 0S/32 configuration 


utility program (CUP) device statements on the left, and the 
Sysgen/32 device statements on the right. 


Examples: 
CS/32 CUP SYSGEN/32 STATEMENTS 
STATEMENTS 
DEVICES . CEVICES 
1:F0,0 CSCi:, C6, 51, SELCH=FO, CONTR=86 
2:B6,0 CSC2:, C7, 59, SELCH=FO, CONTR=B6 
3 BDSC1:C6,51,D MAG1, 85, 65, ILEVEL=1, SELCH=F1, CONTR=0 
* DSC27C 71950 ¢D CON:, 10, '39, CONSOLE, ILEVEL=2 
ILEVEL 1 ILEVEL 3 
1:F1,0 FRT:, 62, 114 
2:0,0 VDU1:, 12, 39 
3 MAG1:85,65 VDU2:, 14, 39 
ILEVEL 2 ILEVEL 1 
1 CON: 10,39,C MAG2:, C5, 65, SELCH=F2, CONTR=1 
ILEVEL 3 *NOTE THAT THE CONTROLLERS FOR MAG1: and MAG2: 
1 PRT:62,114 *ARE UNIQUE. 
1 VDU1:12,39 ENDD 
1 VDU2:14, 39 
ILEVEL 1 
1:F2,0 
z:0,0 
3 MAG2,C5,65 
ENCDD 
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2012-12 DIRECTORY Statement 
The DIRECTORY statement specifies that secondary directory 
Support is included in the system. 
Formats: 
DIRECTORY 


Functional Details: 


If this statement is omitted, no secondary directory support is 
included. If a disk is marked on with the CDIRECTORY parameter 
specified in the operator MARK command, and the system is built 
with directory support, file search time is reduced. Marked-on 
disks require the following additional working storage areas: 


e system space of 64 bytes for access control blocks (ACB), and 
® a secondary directory buffer with a default buffer size equal 


to 1024 bytes. The default value can be overridden when the 
disk is marked on. 


Secondary directory support occupies 2.5kb of memory. Refer to 
the 0OS/32 Application Level Programmer Reference Manual for 
detailed information. 
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2-12.13 DISCBLOCK Statement 


The DISCBLOCK statement specifies the maximum physical block size 
that can be allocated for an indexed file. 


Format: 


piscsLock [=] * | 


Parameters: 


n ? is a decimal number fron 1 £4through 255 
indicating the maximum number of 256-byte 
segments that can be specified for data or 
index blocks in an ALLOCATE command or an SVC 
7. jdIf this parameter is omitted, 4 is the 
default. 


Functional Details: 


Allocation of the physical block size occurs when the file is 
assigned. If no direct access devices exist in the system, omit 
this statement. Larger blicock sizes occupy more System space, but 
reduce physical I/O and improve system performance. Refer to the 
OS/32 System Level Programmer Reference Manual for the required 
program block size. 


2-18 48-037 FOO ROO 


2012614 DsYs Statement. 

The dynamic system space (DSYS) statement specifies the default 
humber of kilobytes (kb) of available dynamic system space. The 
size of system space can be adjusted by the SET SYS operator 
command after the system is builte The following dynamic control 
blocks are allocated in system space: 

e Private file control block (PFCB) 

e File control blocks (FCB) 

@ Task control blocks (TCB) 

@e Timer queue elements (TOE) 

e Access control blocks (ACB) 


e Segment description elements (SDE) 


e Private segment tables (FST) 


Formats: 


Parameters: 


n is a decimal number from 1 to the total number 
of kilobytes of memorye If n is omitted, 25kb 
is the default. 


Functional Details: 


If this statement is omitted, 25kb is the default. 
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201-15 ENDC Statement 


The ENDC statement must be the last sysgen statement specified 
and indicates the end of all sysgen configuration statements. 


Formats: 


ENDC 
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2-12-16 ERRORREC Statement 


The ERRORREC statement specifies that error recording support is 
included in the systen. 


Format: 


ERRORREC [=] fd,size,period 


Parameters: 


fd is the file descriptor of the default error 
recording file. The specified file is 
assigned by the system as the default error 
recording file. 


size is a decimal number from 1 through 32,767 
specifying the maximum number of 256-byte 
records in the default error recording file. 


period is a decimal number from 1 through 1440 
specifying the minutes that elapse between 
memory error recording readouts on the Models 
3210, 32290, 3230, 3240, and 3250 processors 
only. The recommended period is 2 minutes. 


Functional Details: 
Error recording supports recording of: 


e I/0 errors for all processors 
e System errors for all greccessors 


@e Memory errors for Perkin-Elmer 3200 Series 


There is no significant increase in averhead cost incurred by 
recording I/O and system errers. 


The Perkin-Elmer 3200 Series processors contain error recording 
memory and an optional error logger. If this statement is 
specified, the hardware error logger is periodically read and the 
data is written to the error recording file for subsequent 
reporting. If this statement is omitted, error recording support 
is not included in the system. 
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201-17 FLOAT Statement 


The FLOAT statement specifies that floating point SUppOort 
(software or hardware) is included in the system. 


Formats: 


S79 


FLOAT [=] 


Parameters: 


Ss indicates software floating point is supported 
for single precision floating point in the 
first Farameter and for double precision 
floating point in the second parameter. 


H indicates hardware floating point is supported 
for single precision floating point in the 
first Farameter and for double precision 
floating point in the second parameter. 


N indicates no floating point is supported. 
Functional Details: 


Software floating point support shauld be included only in 
systems that do not support hardware floating point. If the 
hardware floating point parameter is not specified for a system 
with hardware floating point, memory is wasted and unpredictable 
results occur after a power fail/restore sequence. Single 
precision floating point support occupies 1.9kb of memory, and 
double precision floating pcint support occupies 2.9kb of memory. 


If the FLOAT statement is omitted, H,H is the default for the 


Perkin-Elmer 3200 Series rrocessors, and N,N is the default for 
the 7/32 or 8/32 processors. 
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2e1-18 ILEVEL Statement 


The ILEVEL statement specifies the hardware interrupt levels for 
all devices that are specified between this ILEVEL statement and 
another ILEVEL statement or the ENDED statement. 


Format: 


ILFVEL [=] 


Parameters: 


3 is a decimal number indicating the fourth and 
lowest interrupt level at which a device can 
interrupt. 


2 is a decimal number indicating the third 
interrupt level at which a device can 
interrupt. 


1 is a decimal number indicating the second 
interrupt level at which a device can 
interrupte 

0 is a decimal number indicating the first and 


highest interrupt level at which a device can 
interrupt. If this parameter is omitted, 0 is 
the default. 


Functional Details: 


If multiple I/O interrupt levels are not to be included in the 
system, omission of this statement causes all devices to be 
configured at the highest interrupt level, 0. A group of devices 
configured with the same SELCH or disk controller address must be 
configured at the same interrupt level. Therefore, the ILEVEL 
statement should directly precede the group of devices to be 
configured at a specific interrupt level. 


The ILEVEL parameter in the device statement is used to redefine 


the interrupt level for a particular device without affecting the 
global interrupt level setting. 
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201.19 INTERCEPT Statement 


The INTERCEPT statement indicates that supervisor call (SVC) 
interception support is tc be included in the system. 
Formats 

INTERCEPT 


Functional Details: 


If this statement is omitted, SVC interception is excluded from 
the operating systen. 
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221-20 IOCLASS Statement 


The IOCLASS statement specifies the global class setting to be 
associated with a particular device or group of devices used for 
accounting. 


Formats: 


Iocuass [= 


Parameters: 


ce is a decimal number from 0 through 34 
specifying the class associated with devices 
or files. If this statement or the parameters 
are omitted, 0, 1, 2, and 3 are the default 
classes. 


Functional Details: 


(A global IOCLASS can be specified or changed by entering the 
IOCLASS statement immediately preceding the device or group of 
devices to be associated with that class.) All devices are 
associated with that IOCLASS statement until the next IOCLASS 
statement is entered. 


The IOCLASS rarameter in the device statement redefines the I/0 
class of a particular device and does not affect the global I/0 
class setting. 


User-specified I/O classes must be within the range specified by 


the ACCOUNTING statement. See Section 2.1.1. Table 2-3 lists 
the default device and file classes. 
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TABLE 2-3 DEFAULT DEVICE AND FILE CLASSES 


CLASS | DEFAULT | 
BSrrssss sess sssssrsstsesssrsssesessrz== | 
0 | Logical I/0 (indexed files)* | 
| | 

4 | Physical I/O with SELCH* | 
{| (contiguous files) | 

| | 

2 | Physical I/O with multiplexor | 
| channel (VDUs) | 

| | 

3 | Logical spooled I/0 (spooled {| 
| | 


output) 


*The accounting facility requires 
classes 0 and 1. 
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2ete-21 ITAM Statement. 


The ITAM statement indicates that communications support is to be 
included in the system. 


Format: 


iTAM 


Functional Details: 


Communications support consists of system modules, drivers, and 
device control blocks (DCBs, CCBs, etc.e). The drivers are stored 
in either the communications driver library or extended 
communications driver library. The system modules are stored in 
the system communications library. See Chapter 3. 
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| JOURNAL | 
201-22 JOURNAL Statement 

The JOURNAL statement specifies the maximum number of journal 
entries for the system. The system journal is a list of data 


entries that records operating system events and is used for 
tracing the cause of a system failure. 


Formats 


JOURNAL [=] 


Parameters: 


n is a decimal number from 0 through 12,999 
specifying the maximum number of journal 
entries. The number 0 is the default. 


Functional Details: 


The amount of memory required for the user-specified number of 
journal entries is calculated as: 


noe of bytes for journal = 20 x (n+8) 
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{ LOGLEN i 


201-23 LOGLEN Statement 


The log message buffer length (LOGLEN) statement specifies the 
maximum number of bytes of message bufifer size in the system. 


Format: 


Parameters: 
n is a decimal number from 32 through 132 
specifying the maximum number of bytes of 
message buffer size. If this parameter is 


omitted, 72 is the default. 


Functional Details: 


This statement sets the message buffer size for user tasks 
executing SVC 2 code 7 log message calls. If the length of the 
user-specified message is greater than the message buffer size, 
the right-most bytes of the message are truncated. 


When a user task running under MIM issues an SVC 2 code 7 to the 
system console, the user buffer is truncated to LOGLEN. If the 
SVC 2 code 7 is directed to the user terminal, LOGLEN has no 
effect. If this statement is omitted, 72 is the default. 
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i MAXTASK 


201-24 MAXTASK Statement 


The maximum tasks (MAXTASK) statement specifies the maximum 
number of tasks (including rolled-out tasks) that can be in the 
system at one time. 


Formats 


MAXTASK [= 


Parameters: 


n is a decimal number from 1 through 252 


specifying the maximum number of tasks in the 
system at one time. If this parameter is 


omitted, 32 is the default. 


Functional Details: 


If this statement is omitted, 32 is the default. 
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261225 MCONFIG Statement 


The MCONFIG statement must be used if memory error recording is 
desired for a Perkin-Elmer 3200 Series processor. 


Format: 


2 
MCONETG BLOCK=nn,START=xx,RANGE=yy -sunsai-{@} 


Parameters: 


BLOCK= 


START= 


RANGE= 


INTERL= 


SHARED= 
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NORECORD 


,SHARED=< NVRECORD 


RECORD 


nn is a decimal number from 0 through 15 
specifying the area of memory in megabytes 
(Mb) for which a particular memory controller 
is strarped. Blocks have to be specified in 
numerically ascending order starting with 0 
for the lowest megabyte address. For 
Perkin-Elmer 3200 Series processors, 1IMb is 
the minimum specified amount of memory. 


xx is a decimal number from 0 through 15 
specifying the starting megabyte address of 
the block. 


yy is a decimal number from OQ through 16 
specifying the number of megabytes in the 
block. For processors containing less than 
IMb, specify 1. 


C specifies noninteérleaving of memory. 

2 specifies 2-way interleaving. 

4 specifies 4-way interleaving. 

This parameter is optional and if omitted, 0 
is the default. 


defines the memory block as part of shared 
memory. This parameter is optional. 


NORECORD inhibits the processor from reading the error 
logger for the designated block. The block 
configuration is nat verified. 


NVRECORD specifies that the processor should read the 
error logger fer the designated block. The 
block configuration is not verified. This 
facilitates bringing an error logger readout 
online in a multiprocessor configuration 
without destroying valid data in shared 
memorye If this parameter is omitted, the 
designated block is assumed to be in local 
MEMOLTY. 


RECORD specifies that the processor should read the 
error lcgger for the designated block. The 
block configuration is verified at system 
startup time. 


Functional Details: 


As part of the system configuration process, the physical memory 
configuration must be defined if memory error recording is 
included in the system. 


In multiprocessor systems with shared memory, only one processor 
should be designated to read the shared memory error logger. 
This prevents scattering of error logger recordings. 


Example: 


MCONFIG BLOCK=0,START=0, RANGE=4,INTERL=0 

MCONFIG BLOCK=1,START=4, RANGE=4,INTERL=2,SHARED=NVRECORD 
MCONFIG BLOCK=2,START=8,RANGE=4,INTERL=2,SHARED=NORECORD 
MCONFIG BLOCK=3,START=12,RANGE=4, INTERL=4,SHARED=RECORD 
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201226 MEMCHECK Statement 


The memory check (MEMCHECK) statement indicates that memory 
diagnostics support is included in the systen. 


Formats: 


MEMCHECK 


Functional Details: 


The memory diagnostics program is executed at initial program 
load (IPL) time. If any bad or unavailable pages exist in memory 
(256-byte pages for Models 3210 and 3220 processors; 2048-byte 
Pages for Models 3230, 3240, and 3250 processors), the operating 
system marks them as unavailable. Memory can also be tested, 
marked off, and marked on by the operator MEMORY command if 
memory diagnostics support is included. 


48-037 FOO ROO — 2-33 


2e1e27 MEMORY Statement 

The MEMORY statement specifies the maximum number of kb of 
available local memory for the system. Local memory isa 
contiguous memory area starting at absolute address 0 and 
consists of thes 

@® operating system, 

e dynamic system space, 

® reentrant library segments (optional), 


e task common segments (optional), and 


@e pure and impure segments. 


Format: 


MEMoRY [=] , 


Parameters: 


n is a decimal number specifying the maximun 
number cf kb of available local memory. The 
number is in increments of 16 and ranges from 
256 through 1024 for the Models 7/32, 8/32, 
3210, and 3220 processors; 4096 for a Model 
3239 processor; and 16,384 for the Models 3240 
and 3250 processors. If this parameter is 
omitted, 256 is the default. 


Functional Details: 


If the operating system memory size exceeds the memory size 
specified by n, the error is not detected until a load module is 
created by 0S/32 Link. The size of local memory can be changed 
by the operator MEMORY command. If this statement is omitted, 
the default is 256. 
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2014628 MODULE.eeENDM Statements 


The MODULE..eeFNDM statements substitute a user-written or 


user-modified system module for a Perkin-Elmer standard system 
module. 


Format: 


MODULE 
hew module name, 


new module hame, 
i e 
e 


new module name, 


ENDM 
Parameters: 


new module is a 4-character name, a period, and a 

name 3-<character variation (ffff.xxx) indicating 
the user-written or user-modified module to be 
selected. If the name (ffff) is the same as 
the standard module name, the variation (xxx) 
overrides the variation normally selected at 
sysgen time. However, if the name is not the 
same as a standard module name or USERexxx, an 
error is generated. 


"8-037 FOO ROO 2-35 


201-29 NOSEG Statement 


The no memory segmentation (NOSEG) statement specifies that 
memory segmentation support is excluded from the system. 
Format: 

NOSEG 


Functional Details: 


When segmentation support is excluded, tasks that were previously 
established in pure and impure segments cannot be loaded into the 
systeme Exclusion of segmentation support causes inefficient use 
of memory through the loss cf shared pure segments, If this 
statement is omitted, segmentation support is included. 
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2e1.30 QUEUE Statement 


The QUEUE statement defines the maximum number of entries in the 
System queue used to schedule driver operation. 


Formats 


gueve [=] 


Parameters: 


n is a decimal number from 1 through 64,999 
specifying the maximum number of entries in 
the system queue. If this parameter is 


omitted, the total number of devices in the 
system is the default. 


Functional Details: 


The minimum number of entries should be equal to the total number 
of devices (including nodes, channels, and controllers), because 
driver termination routines do not check for sufficient room on 
the system queue when adding entries. 


If this statement is omitted, the total number of devices in the 
System is the default. 
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2-1-3141 ROLL Statement 


The ROLL statement 
system. 


Formats: 


specifies that roll support is included in the 


ROLL [=] [rvoin] 


Parameters? 


rvoln 


Functional Details: 


is a 1- to 4-character volume name specifying 
the default roll volume. The first character 
of the volume name must be alphabetic and the 
remaining, alphanumeric. If this parameter is 
omitted, blanks are generated as the volume 
namee 


When roll support is specified, at least one direct access device 


must be included. 


If this statement is omitted, roll support is 


excluded from the system. 
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22-12-32 SPOOL Statement 


The SPOOL statement specifies that spool support is included in 
the system. : 
Format: 

spooL [=] [spvoin] 


Parameters: 


spvoln is a 1- to 4-character volume name specifying 
the spool volume. The first character of the 
volume name must be alphabetic and the 
remaining, alphanumeric. If this parameter is 
omitted, blanks are generated as the volume 
namee 


Functional Details: 


When spool support is specified, at least one direct access 
device must be included. If this statement is omitted, spool 
support is excluded from the system. 
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| SSTABLE | 
201-33 SSTABLE Statement 
The SSTABLE statement specifies the maximum number of shared 


segment table (SST) entries to be reserved in the system. 


Format: 


Parameters: 


n So oe is a decimal number from 1 through 8192 
specifying the maximum number of SST entries 
allowed in the system. If this parameter is 
omitted, the default is 32. 


Functional Details: 


The Models 3216, 3230, and 3240 processors use an SST. Each SST 
entry requires 8 bytes. Space for the table is allocated in 
256-byte blocks. If this statement is omitted, 32 is the 
default. 
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| STARTUP..eENDS | 


221-34 STARTUP..-ENDS Statements 


The STARTUP..e-ENDS statements define a startup CSS _ procedure, 
executed at system startup. This feature allows DISCHECK to run 
automatically and loads the tasks necessary to create the system 
environment. 


Formats: 


STARTUP 


ENDS 
Functional Details: 


The CSS procedure is executed before the SET TIME request is 
issued by the system. If a SET TIME request is issued from the 
startup CSS, the operating system ENTER DATE AND TINE request is 
not made. 


The CSS commands are stored in memory in packed format. This 
memory is not reused during system operation. A large number of 
startup CSS routines could affect the amount of memory available 
for task execution, so startup requests should be as brief as 
possible, making use of such commands as STRANSFER. 


The BUILD..~-ENDB and SBUILD.~--SENDB commands are not allowed in 


a startup CSS procedure, but are allowed ina CSS called from a 
startup CSS procedure. 
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Examples 


STARTUP 

SE T 1/17/81,07:59:59 
SJ 

MA DSC1:,CN,,CD=200 


MA DSC1:,0N,P 

L «BG,DISCHECK,50 

T BG 

MA DSC1:,0FF 
ST,DSC1:,CON:,NOR 
MA DSC1:,0N,,CD=200 


SWR *** MARK OR CHECK ERROR ON DSC1s *** 
SEX 
SEN 
SEN 
STR STARTUP 
ENDS 
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21-35 TCOM Statement. 


The task common (TCOM) statement defines and reserves’ system 
storage for TCOM segments in global memory. Global memory 
(shared memory) is located outside of local memory. Local memory 
is defined by the operator MEMORY command. 


Format: 
TCOM [=] name,,address,,size, [/.../name,,address,,size, ] 
Parameters: 


name is a TCOM segment name from 1 to 8 characters 
corresponding to a labeled common segment name 
in a user programe The first character of the 
segment name must be alphabetic and the 
remaining, alphanumeric. 


address is a hexadecimal number within the ranges 
specified in Table 2-4 specifying the absolute 
address of a TCOM segment located outside 
local memorye The user-specified number is 
rounded down to the nearest 256-byte page 


address. 

size is a decimal number in increments of .25kb, 
from .25kb to the maximum amount of global 
memoCye 


Functional Details: 


Global memory is located above MTOP, the area specified in the 
operator MEMORY command, and is limited by the physical memory of 
the system. If the address specified is greater than the 
physical memory of the machine, the error is not displayed by 
Sysgen/32. All TCOM segments must be specified in order of 
ascending physical addresses». A maximum of 14 TCOM segments can 
be defined. Overlapping TCOM segments are not allowed. 
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TABLE 2-4 TCOM ADDRESS RANGE 


CPU. | ACDRESS RANGE | INCREMENT SEGMENT SIZE (KB) 
SSrsSsSsse2SSS SoS SS SS SS SST SS SSS HSS SSH SsSssetsSS SSS SSS 52252 5S52=5= 55S E==522=55=5=2=5= 
7/32 |  1-FFFOO | - 256 
8/32 | 1-FFFOO | » 256 
3210 | 1-3FF800 2.048 
3220 | 1-FFFOO { - 256 
3230 | 14-FFF800 | 22048 
3240 | 1-FFF800 | 22048 
3250 | 1-FFF800 2.048 
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21-36 TEMP Statement. 


The temporary (TEMP) statement specifies the default volume name 
to be used for temporary (scratch) file support. 
Formats 


TEMP [=] Fevoin] 


Parameters: 


tvoln is a 1- to 4-character volume name specifying 
the default temporary volume. The first 
character of the volume name must be 


alphabetic and the remaining, alphanumeric. 
If this parameter is omitted, blanks are 
generated as the volume name. 


Functional Details: 


Temporary file support is always included in the system. If this 
command is omitted, the default temporary volume name is set to 
blanks. Temporary files are allocated at assign time and deleted 
at close time. To exclude temporary file support, a source 
sysgen must be performed cn modules CMDB, CMSP, and FMS7. 
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2.1.37 TGD Statement 


The trap-generating device (TGD) statement 
device support is included in the system. 
Formats: 


GD 


Functional Details: 


specifies that TGD 


If this statement is omitted, TGD support is excluded. See the 
0OS/32 Application Level Programmer Refierence Manual. 
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2-12-38 VERSION Statement 
The VERSION statement specifies a user version that is associated 
with a particular operating system sysgen. 
Format: 
VERSION [=] [vvvvvvvv_] 


Parameters: 


VVVVVVVV is an 8-character alphanumeric string 
specifying the version of a particular 
operating system sysgen.e. If this parameter is 
omitted, blanks are generated as the version 
number. 


Functional Details: 


The 8-character version, in addition to the operating systen 
revision and update number, is displayed on the system console at 
system initialization time in this format: 


OS32MTrr-uueVVVVVVVV 


If this statement is omitted, blanks are generated as the 
version. 
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2-11-39 VOLUME Statement 


The VOLUME statement specifies the name of the default system 


volume. 


Format: 


votume C=] Lvoin] 


Parameters: 


voln 


Functional Details: 


is a 1- to 4-character volume name specifying 


the default system volume. The first 
character of the volume name must be 
alphabetic and the remaining, alphanumeric. 
If this parameter is omitted, blanks are 
generated as the volume name. 


After sysgen, the operator can change the volume name through the 
operator VOLUME command. 


If this statement is omitted, blanks are generated as the volume 


-namee 
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| CHAPTER 3 
LIBRARIES REQUIRED FOR SYSTEM GENERATION 


3.1 INTRODUCTION 


The Sysgen/32 process requires standard system libraries, general 
purpose driver libraries to support the devices listed in Chapter 
4, and system and Sysgen/32 macro libraries. These libraries are 
required for the macro expansion and link phases of the  sysgen 
procedure. Other system libraries that may be required by the 
Sysgen/32 process are system communications libraries if 
communication devices are ccnfigured in the operating system, and 
user libraries if user-written devices are configured in the 
Operating system. 


OS/32 supports two types of system generation: 


e Cbject-level 


e Source-level 


The object-level sysgen enables a user to configure an operating 
system tailored to specific needs by selecting driver and system 
modules provided in the OS/32 package. Assemblies of systen 
modules are not required in performing an object-level sysgen. 


The source-level sysgen enables a user to modify the O0S/32 system 
modules and drivers. This procedure requires reassembling one or 
more system and/or driver source modules, replacing existing 
versions of these modules in the system or driver libraries with 
the user-modified modules, and executing the object-level sysgen 
procedure. Section 3.6 presents sample source sysgen procedures. 
3.2 STANDARD LIBRARIES (OPERATING SYSTEM) 

There are two standard libraries required for the Sysgen/32 
process: 

e The standard system library (SYS-LIB) 

e The standard driver library (DRIVER.LIB) 


These libraries are used in the link phase of the Sysgen/32 
process and are available in both object and source versions. 
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322-1 Standard System Library (SYS.LIB) 


Table 3-1 presents a descrirtion of the source sysgen options 
that can be included in a target system. 


The source sysgen modules of SYS.LIB are listed in Table 3-2. 
These modules can be altered by the sysgen parameters in the 
sysgen parameter file. Table 3-3 is a list of the source’ sysgen 
parameters and the amount of memory the desired sysgen option 
occupies. 


Each module has an extension number corresponding to functional 
variations supporting various sysgen options. Table 3-4 is a 
list of module variations in SYS.LIB. The standard variations 
provided in SYS.LIB are a subset of possible variations. A 
source level sysgen may be optionally performed to include or 
eliminate options in a specific module. A source-level sysgen 
may also be optionally performed to eliminate specific 
source-level sysgen options included in all module variations. 


TABLE 3-1 SOURCE SYSGEN OPTION DEFINITIONS 


oO 
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| 
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ee ee ee ee ae ee ee ee ee ee ee ee ee ee Oe a ae ee Se ne ee ee DS om SD DS me ee fee ED Oe GD ED Sm SS ED OED 28) OS OR GTS oom Gun ON) 4D mS a oe ow 


Journal Supports recording of normal | 
support internal system events ona | 
| 
| 


| 

{ 

{| circular list in memory. Used 

{ as a debugging tool for opera- 

| ting system development and is | 
| recommended for installations | 
| where user-written or user- | 
| modified modules are tested. i 


| Safety check | SAFE {| Supports consistency checking | 
| support | {| within the operating system. | 
| | | Detected inconsistencies re- | 
{ | { sult in a system failure. | 
Te taselabedainigiatoas rie pte meer rind ac tc OEE RES ae aE | 
| System debug | DBUG | Supports debugging of the | 
| software | | operating system. Includes | 
| support | | consistency checks not in- ] 
{ | | tended for operational systems. | 
peeping a aa Reet aE RSL ase aR NS | 
{ Bulk command | BCMD {| Supports bulk storage operator |} 
{| module support | | commands such as WRITE | 
| | | FILEMARK, FORWARD FILEMARK, | 
| | | FORWARD RECORD, BACKSPACE | 
| | | FILEMARK, BACKSPACE RECORD, | 
| | | and REWIND. | 
Ti paca saeco Pca neg ce aL SSS oor see | 
Contiguous CO Supports contiguous files on 


file support 


| | 
{| direct access devices. Re- | 
{| quires that direct access jf 
| support also be included. | 
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TABLE 3-1 SOURCE SYSGEN OPTION DEFINITIONS (Continued) 


{MNEMONIC 


OPTION 


Indexed file 
support 


Direct access 
device support 


Secondary 
directory 
support 


Spooling 
support 


Roll support 


support 


segmentation 
support 


| 
| Link overlay 
{| support 

| 
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DEFINITION 


Supports indexed files on 
direct access devices. Re- 
quires that direct access sup- 
port also be included. 


Supports direct access bulk 
storage devices (disks) 
beyond the basic I/0 device 
level, including primary dir- 
ectory support, sector alloca- 
tion, bitmap support, and vol- 
ume mechanism Supporte 
Includes the DISPLAY FILES, 
DELETE, XDELETE, VOLUME, MARK 
operator commands. 


Supports the secondary direc- 
tory feature that provides an 
in-memory paged index to the 
disk directory to reduce 
access time for directory 
operations. 


Supports the Spooler. Requires 
that indexed file support and 
direct access file support be 
included. 


Supports rolling of tasks to 
disks to execute more tasks 
than can fit into available 
task memory. Requires direct 
access support. 


Supports use of sharable seg- 
ments such as pure (reentrant) 
segments, run time libraries, 
and task commons. 


Supports loading and executing 
overlaid tasks produced by 
0S/32 Link. 


nap Se cee ee GERD eee a SE ee ee ee eee ee ee ee ee eee ee eee eee ees oe 


TABLE 3-1 SOURCE SYSGEN OPTION DEFINITIONS (Continued) 


OPTION {MNEMONIC | DEFINITION | 

SSS SSHS HS SS HS SSH HS SSS SSH SSS SSS SSS S SSS SS SS SSS SHS SSS SSSSSssT=s=| 

Communications | ITAM | Supports communications de- | 

support | | vices. | 
Trap- TGD Supports the 8-line interrupt 


Selectidon of a scheduling 
algorithm is specified in 


| 

| | | 

generating | | module, providing task traps | 
device support | } in response to external | 
| | interrupts. | 
ee eee ee ee ee | 
Double | DF | Supports double precision | 
precision | | floating point in a system | 
floating point | { without the hardware to | 
software { | support ite Includes software | 
support | {| emulation routines for double | 
| | precision instructions. | 
ee ee ee | 
Single | SF | Supports single precision | 
precision | | floating point in a system | 
floating point | | without the hardware to | 
software | | support it. Includes software | 
support | | emulation routines for single | 
| | precision instructions. | 
ee ee ee er eee ee es | 
Power fail op- | PWF {| Supports operator control for | 
erator inter- | | power fail/restore sequence. | 
vention support | | | 
cee we ww ewer ece eae trees ew ewe aewa wows wae eran eww ewww ewe ww ew eee eee www | 
Time delay on {| DLAY | Supports a time delay on | 
power restore | | power restore prior to | 
support | { enabling interrupts. This is ] 
| { required for configurations | 

| { with wilh amauta bus PE EChees { 

eee wwe een wm we www we mew we wm www ewe ww ew Oe we Bee eww we ww we ee we ww oe { 
seek SEEK Supports estan seek sched- | 
support uling on disk devices. | 
| 

| 

| 


{ 
| 
| 
| 
| each disk device control block 

{ (DCB). Standard driver library] 
| has seek scheduling enabled for] 
| all disks except floppy. This | 
| option is required to support | 
| those disks. | 
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TABLE 3-1 SOURCE SYSGEN OPTION DEFINITIONS (Continued) 


i OPTION |MNEMONIC | DEFINITION | 
| pt SSS S555 55=>= Sar e=ssaees sess sseas=| 
| Extended direct] EDMA | Supports coordination of | 
{| memory access | { multiple extended direct | 
{ support | | memory access (EDMA) devices. | 
| { | required if the EDMA devices | 
| | | exceeds the bandwidth | 
| { {| capability of the EDMA bus. | 
{ | | This coordination mechanism is |{ 
| | {| also used for floppy disk | 
| | | systems where the adapter | 
| | | bandsidsh is limited. | 
aca als since ita eaie aisles eines acme Be a aa SG a GA AO 
| Memory | MCHK | Sas pones memory testing | 
| diagnostics | {| features for initial system | 
| supvort | {| load and at the request of | 
| | | particular operator commands. | 
| | { Finds and marks off bad | 
| | | memory. { 
[eee steneeneracseassoean one e= Sis MAan OED assist gl ROR | 
| Memory error | MERC | Supports recording of memory | 
{ recording | | errors generated by the | 
| support | | system. Requires that general | 
| | | error recording is selected. | 
{ | | Available for Models 3210, | 
| { | 3230, 3240, and 3250 processors| 
| | j only. : 
| ee bo mew nwanae eee eww oma ewww emo mee woman meneame 

| General error {|{ GERC | Supports error recording of | 
| recording | {| memory, I/O, system errors and | 
| | {| system milestones. | 
{ Sarasa nae eeone awa Danna weeaaneae see ewan nemaee ena wae ee ae oe me 

| Models 3210, |} 3200 { Supports Models 3210, (3220, | 
] 3220, 3230, | | 3230, 3240, and 3250 proces- | 
1 3240, and 3250 | | sors. ! 
| support { | | 
| HE OOOOH SEO wD Oa See eee Oe See Sener ee ena aw ee wm ao = = 

| Memory access | ATM | Supports MAT on Models 3210, | 
{| translator | { 3230, 3240, and 3250 proces-| 
| Models 3210, | | SOrs. Must be removed for | 
{| 3230, 3240, | | Models 7/32, 8/32, and 3220 | 
{ and 3250 | {| processors. j 
| support | | | 
| Seman ae OO eae wee CBee Eee eww ewe eZee ema enw enw ew ee we ew em ee em ee we 

| Accounting | ACCT | Sypnorts job accounting of | 
| facility | | system resources. | 
| support | | | 
{ a ne ne ee ee ee eee 

| No file | ACCF | No accounting records are | 
{| accounting | | generated for file renames and | 
| { 


eeteres: 
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TABLE 3-2 SYSTEM SOURCE MODULES AND SUPPORTED FEATURES 
SOURCE MODULES | SUPPORTED FEATURES 

| IJ |S {DD {B JC JI {D ID {IS IR IT IS JA FI IT (ID IS [TP [RD IS JE [M [mM {EG 13 JA JA JA 

| IR JA [B 1C JO JN JA [I [P JO TE JE JO [T IG {F IF [WIL JE ID fC FE JE 42 YT Ye Jc 

| IN IF JU IM — UX | ER [O FL IM IG TV JA ID | Tf YF YA TE UM TH FR IR JO [M Jc fc 

FUNCTICN | NAME IL 1E 16 ID | | 6tlhUE CU I de ow doth UK OYA IK fc [ec jo | qt dF 
Console | [OR ORS ee Se Se a a) a ie US sy <a hs CR IY th oe eh 
Driver | cDVRe-MAC [| [| 7 = ft €— | | tt & t § t +t § F bt ' tb bt tl bl had 
Display and | bE bob hoa oe oD obo ce oh a Pec de on oP OD, 4 he Pa, Ae A 
Bulk Command | CMDBeMAC {| | JI Ix | ¢{ Ux Ix Ix Ix Ix | § Ix | TF | =F FE bt ft t | ft t § tt 
Command | Boe OF Deo a cp eRe ob a ae BR be ob ot al, oe aD oko eb ae a a a 
Executors {| CMEX-MAC { [| {| [| FT F © Ut te | t F§ FE tke F | t t § § t te | Fo bt bt tt 
Console | ft’ | t § dt ft tt t t | t §F t t FT t t tf Fo od t be tl cb 
Monitor { CMON.MAC | | {| TFT F- - | Ft EF t § § F t §F § FE tt t t t t § t § 1 4 
Console and { {eT oF 1-7 4-6 2 4 F&F AED EG DP TD Oh EP OP DEP ee Ee ET 
CSS | it | ' t t ff § § tf § § § t § — FT bt t t t § t t t § tod 
Supervisor { CMSP.MAC {x | | | ¢F F Ft FE UE t ted ft t t F§ t t ft § §& tt ft t § td 
Error | 1’ t t¢ Ft t tt t t t t | Ft bt t t tt t § § Fo ob be tt dd 
Recording { ERRC.MAC [| {| ff | | €— | J Ud t t F § t § bt t § t t t tx tke | ot tf 
Accounting | bP he Re he Sp Ro Se de A eh ees oi Se ek WE. Cis aie sf de 

Facility | ExaceMAC | | | | $ YF t tt t F | t § € F § F ft t t §t t tT bt bt ot tx tx 
Interrupt | iit ¢ &€ t £— & t tf + t § t t § § § te tlh hm la 
Handler | EXIN.MAC [x tx | — ¢§€ ¢€ € F t Tt t t te te | to ot tx tx t ft te tx tote tx ix I 
Input/Output | EXIO.MAC |x Ix {| | | 72 ¢t FY FF | € F tt t F ' t t t te tx — to ot tl Ut le I 
Loader and | (Bs se Poe eR ie Te i a Se SR fs a a he ok od 
Segment | Pook. Be “he eB ob BB boos OE OI a ee te OP ke ite 
Control } EXLDe-mAC | | Ix 1 — | $ € © de do dx te Ff F F Pb tr t bo fb te t t F te ft ot 
Henory Ecce eee, td: Ae We hoe le Ee aks aed Ae ie eae Te i eal Pah le ca oe oc 
Manager | EXMY-MAC jf fx f Gf 7 GG ie | GF ixi ft FT tf i tft tt t G@ $F FF F t € tt tt 
Superviscr | Poo «hh oe oe ee ah ON SE he a RO Ok CR ee A Ob Oe SO A fh Pe at ad 
Services | EXSP.MAC |x | | | ¢€ € EF t te t | Ft bt bt t tt ' t t bt t t t ft te tod 
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| 
{x |x 
I 
| 
{ 
| 
| 
| 


| EXSV.MAC 

| EXTM.MAC 
FMS7.MAC 
INTC. MAC 
INTCD2. MAC] 
DUMP. MAC 
ITFM.MAC 


} FLTP.MAC 
| 
| 
| FMCO.MAC 
| MCHK.MAC 


I 
| UBOT.HAC | 
i 
| 


| Communications] 


LEGEND 
X = supported source module features 


Timer Manager | EXTI.MAC 


Task Manager 
Interrupt 
Interrupt 

File Manager 
Utility 
Routine 
Intercept 
Manager 

End of System | 
Nodules 


Svc 7 
Jj Diagnostics 


| Floating 

| Point Traps 
j Contiguous 
{ File SVC 1 
j Memory 

| Support 
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Certain features supported by the system source modules might not 
be desired in the user operating system. Therefore, the user can 
change the features that a source module supports. By choosing 
a module whose value equals 0, support for that feature is 
excluded. To include support for a feature, choose a module 
whose value for the specified sysgen option equals 1. 


Example: 
SGN.SPL=1 Spooling support included 
SGN.SPL=0 Spooling support excluded 
Table 3-3 lists the system source modules, source |. sysgen 


parameters and the amount of memory the desired sysgen option 
occupies. 


TABLE 3-3 DEFINITIONS OF SOURCE SYSGEN PARAMETERS 


| | | APPROXIMATE | 
| SYSGEN | | MEMORY | 
| PARAMETERS | LEFINITION | REQUIRED | 
[ HSS SSR HSS SH SS SSS SSS SS SSS SSS SS SSS SS SS SSS SSS SS SSS SSS SSH SESE cSSs= | 
) SGNe-JRNL = 0 { System journal support { N/A { 
| excluded | | 
prsen aac [pire aa er ee age as 
| SGN.JRNL = 1 | System journal support | 205 Kb | 
| | included | | 
[Asetesesee=Ho- lear age aos ae [Soa | 
{| SGN.SAFE = 0 | Safety check support excluded | N/A | 
laden ceionamare ee ae ee es peerage | 
| SGN.SAFE = 1 | Safety check support included | 1-0 kb | 
RS en wee ee en eee jestna== Panes 
| SGN.DBUG = 0 | System debug support excluded | N/A | 
[a igecctcesgiaiaa enna nsec ese Rene aes eonre 
| SGN.DBUG = 1 | System debug support included | 20 kb | 
[eser Seco see Baa Re RG ay aN eee eokae ia Ieee eee 
{| SGN.-BCMD = 0 | Bulk file command support | N/A | 
| | excluded | | 
ae Rica ac aRGiarag™ Sa ins eA Sei aa Rarer eee | 
{| SGN.BCMD = 1 {| Bulk file command support | 0.5 kb | 
| }] included | | 
pereeecee teas Ie ekeeae ince Sarin ahaa aimee ees rae | 
| SGN.CO = 0 j Contiguous file supfort i N/A | 
| | excluded | | 
Eeaaeee oma Nabe teenie 7 Raa aan raEn aes | 
| SGN.CO = 1 | Contigucus file support | 1.0 kb | 


included | | 
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TABLE 3-3 


DEFINITIONS OF SOURCE SYSGEN PARAMETERS 
(Continued) 


| | | APPROXIMATE | 
| SYSGEN { i MEMORY | 
J PARAMETERS | CEFINITICN | REQUIRED | 
[ HS SHES SSS Se eee H SSeS SSS HSS SHR sHN SS ss RSS V Sas SRT Se ReSSsss ss eSss= { 
| SGN.INX = 0 | Indexed file support excluded | N/A { 
opeiyemeuanis ae aacee ose ge aes aeeenarrel | #Sseose=aessee 
{ SGN.INX = 1 | Indexed file Support included | 3-8 kb | 
Taek sar aes ee [Frese ease see 
| SGN.DA = 0 | Direct access support excluded| N/A. | 
| | (if SGN.CC+SGN. INX=0) | | 
eae tan Ga eS eeRES CRORE SIU Enea Gamoegre mieee | 
{ SGN.DA = 1 | Direct access suprfort included] 14.5 kb | 
| | (if SGN.CC+SGN.INX>0) | i 
[peesei eset cron Sera ee ne oe ee [Poeesee eS eee 
} SGN.DIR = 0 | Secondary directory | N/A | 
| {| support excluded | | 
[ngaeseees eee = ee ae Sana SK 1G SeeC RS [Reenter seasss 
| SGN.DIR = 1 | Secondary directory | 2-5 kb | 
| {| support included | i 
[pees esse ore [pee o ease ee Sores seen e ae ake acaace 
| SGN.SPOL = 0 | Spooling Supeert excluded | N/A [ 
[roe eeees oe | goeee tease mang aner eeaaee erica wer i 
| SGN.SPOL = 1 | Spooling eupneEe included | 1-25 kb | 
janeasacee sere je Saeesenresease Steroe et reee puauerradeuze 
{ SGN.ROLL = O {| Roll-in support excluded | N/A | 
gemeueeansans eaciev ar ag amuenauemen earners (eerie aeons 
| SGN.ROLL = 1 | Roll-in support included | 3-1 kb | 
eaeteieesn pistons [esneeatesa ese Reese anaes eeeee [areeeors assess | 
| SGN.TEMP = 0 { Temporary file support | N/A | 
| | excluded | | 
atdegricetaienins lghentsasentnie airee aane REC a EE [oAaasemeseaes | 
{| SGN.TEMP = 1 | Temporary file support | 0.5 kb | 
| | included | | 
[ater seorat ass [eetceresecenaeses meaee oases ass ecg pceaie | 
{| SGN.SEG = 0 | Sharable segmentation | N/A | 
| } support excluded | | 
Eien geet ewan loreccan agate eae jashata sees cee | 
| SGN.SEG = 1 {| Sharable segmentation | 0.5 kb | 
| {| support included | | 
Tnisteudehenteaitaae [poe chee pene cone eae seo se ee [peSaheseesen>= | 
{| SGN.AOVL = 0 | Link overlay support excluded | N/A | 
a peteneceme shines le rare sie man noeiaes Es a aera iia | 
1 SGN-AOVL = 1 | Link overlay support included | 1.75 kb | 
gosaacnenasn lets aaa 4 a ue eas [peecree ses | 
| SGN.ITAM = 0 | Communications support { N/A | 
{ {| excluded | | 
jaseeseesea ests ex duende a Ee neat [eeeee ea eee sess 
{| SGN.ITAM = 1 | Communications support | 0.5 kb | 
| {| included | | 
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TABLE 3-3 


DEFINITIONS OF SOURCE SYSGEN PARAMETERS 
(Continued) 


= =~ «a» a oo oF 48 ae oF an Oo ae oF @ «oe om om am ow oF ow oF @ ow Oe oe gn we we @ aw oe we swe wae wow we we oe 7-2 a we awe ow ee 


| 
|  SYSGEN 
| 


PARAMETERS 


| SGN.TGD 


| SGN.DF = 


| SGN.PWF 


{| SGN.PWFE 


| SGN.MCHK 


a ee EE ee EE eee OE coe cee SE ee qe SS ee ee oe epee GU canes cum cose OU gee ue wee ee eo 


CLEFINITION | 


Trap generating device 
support excluded 


Trap generating device 
support included 


Double precision floating 
point support excluded 


Double precision floating 
point support included 


Single precision floating 
point suprort included 


Operator 
required 


Operator 
on power 


intervention not 
on power failure 


failure 


No time delay following 
power fail/restore 


Time delay following power 
fail/restcre = n seconds 


seek scheduling support 


excluded 


Seek scheduling support 


included 


Extended 


direct memory 


access support excluded 


Extended 


direct memory 


access support included 


Memory diagnostics 
support excluded 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
intervention required | 
| 
| 
| 
| 
| 
| 
{ 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


APPROXIMATE — | 
MEMORY l 
REQUIRED | 

| 
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TABLE 3-3 


DEFINITIONS OF SOURCE SYSGEN PARAMETERS 


(Contin 


ved) 


| 
l SYSGEN 
| PARAMETERS 


| SGN.ACCF = 0 


| oo = a om ewe en anmae 
| SGN.ACCF = 1 
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Memory 
support 


Memory 
support 


Memory 
support 


General 
support 


support 


Perkin- 
cessors 


Perkin- 


diagnostics 
included 


error recording 
excluded 


error recording 
included 


error recording 
excluded 


error recording 
included 


Elmer 3200 Series pro- 
support excluded 


Elmer 3200 Series pro- 


cessors support included 


Models 
memory 


anh ew eB Oe ese ee Bese ees @Qeesaeneaees ea ee w= 


Models 
memory 


7/324 8/32, and 3220 
management 


3210, 3230, 3240, 3250 
Management 


Delete/rename file accounting 


reporti 


ng support excluded 


Telete/rename file accounting 
reporting support included 


APPROXIMATE 
MEMORY 
REQUIRED 


OBJECT MODULES AND SYSGEN OPTIONS 


SYSTEM 


TABLE 3-4 


1 
1 
1 
4 


wrerererenre 


OBJECT SYSGEN OPTIONS 


0 


| VARIATION 
NAME 
| CDVR.FO1 
| CMEX.FO3 
| CMEX. FO 
| CMEX.FO7 
| CMEX.FO8 
| CMON.FO1 
1 
i 
| CMSP.F31 
| ERRC.FO1 
| ERRC.FO2 
ERRC.FO3 
| EXAC.FO1 
EXAC.FO2 
| EXAC.FO3 
EXIN.F11 a4 
EXIN.F12 
EXIN. F413 
EXIN.F14 
EXIO.FO1 
EXIO.FO2 


SYSTEM CBJECT MODULE 


FUNCTION 
Console 
Driver 
Display 
and Bulk 
Commands 
Command 
Executors 
Console 
Monitor 
Console and 
css 
Supervisor 
Error 
Recording 
Accounting 
Interrupt 
Handler 
Output 
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Thee 


TABLE 3-4 SYSTEM OBJECT MODULES AND SYSGEN OPTIONS (Continued) 


OOY 00d LEO-8h 


Diagnostics { MCHK.FO2 j j |f0 


| 

{ | IJ $S |D 

| I IR JA {B 

{ | VARIATION |{N |F |[U 

{| FUNCTION { NAME {L JE |G 

| SSSser eros Stree sees Se KS S SH SST RS SSSS SSS SS SSS SS SSS SSS SSS SSS SSS S SS SSS SSH SSS SSS SSH las S SSeS SSeS SSS SSTSsSSSSssSS= 
| Indexed | i t 

| File SVC 1 | i tf 

{ Interrupt | FMIN-FO7? | | 

| eee ween mmo ee we ee ew me mmm ee wee ew we ewe wwe ooo 
{| SVC 7 | FMS7.FO2 {| | | 

{| Interrupt {| FMS7-F43 | | | 

| { FMS7.F4au | |{ | 

| FMS7.Fa7 | | { 

| FMS7.F48 | { | 

{ ewe mee eee ew we wm we ow wee me ew wwe ee mow ew eee eee wane 
| File | FAUT.FO2 | |{ | 

| Manager {| FHUT.F25 | | | 

| Utility { FMUT.F26 | | | 

| Routine | FMUT.F27 | | 4 

| | FMUT.F28 | | {| 

| weeeseeee eee eee eee ee we wee ees Oe wm ewe eee wwe woe 
| svc | Pooh od 

| Interception] INTC.FO1 | [{ | 

{| Support { INTC.FO2 | |{ | 

| ewer eee wee wwe wm ww ee ee eee en owe eee oe eo we we we wee we we ew we ow www eee we ww wm we ew em em meee eww wow ew wow wo om Poko 
| Memory {| MCHK.FOC1 | | 0 

{ 

| 

| 

| 


{Communica- | i t 4 
jtions Support| ITFM.M00 | | {| 
| eeceaewe ee Se eeweo wooo nan we eee oe ee ee oem Coe ww we we Bee we wees woe ewe we em ee eee ec owewooeeococe 
| Patch Area | UBOT.FO1 | {| | 
LEGEND 

0 = feature is not supported 

1 = feature is supported 

5 = 5 second delay on power for restart 

shading = variation 


3e2e2 Standard Driver Library (DRIVER.LIB) 

The standard driver library, DRIVER.eLIB, is required in the link 
phase of the Sysgen/32 process. DRIVER.LIB is available in 
object and source versions. The source modules can be modified 
and included in the driver cr user library. 

3.3 STANDARD COMMUNICATIONS LIBRARIES 

There are two standard communications libraries required in the 
link phase of the Sysgen/32 process, if communications devices 
are to be configured in the operating systems 


e The standard communications system libraries 


e The standard communications driver libraries 


323-1 Standard Communications System Libraries 


Table 3-5 presents the standard communications system libraries. 


TABLE 3-S STANDARD COMMUNICATIONS SYSTEM LIBRARIES 


| LIBRARY DESCRIPTION } LIBRARY NAME | 
| Sr SSSertreVessrreBVSVEaASSSS TPS Tesa2SSS2S S252 222225255222 =2== | 
| Basic communications pack- {| ITBSYS.LIB | 
J} age library { | 
| | | 
| 2780/3780 enhancement } ITES2780.LIB | 
| | | 


package library 


These libraries are available in object and source versions. 
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3.3.2 Standard Communications Driver Libraries 


Table 3-6 presents the standard communications driver libraries. 


TABLE 3-6 - STANDARD COMMUNICATIONS DRIVER LIBRARIES 


| LIBRARY DESCRIPTION | LIBRARY NAME | 
[Hee srseeceerStassrssssHssasssssaeeesseassessaa| 
| Basic communications package | ITEDLIB.LIB | 
| driver library | | 
| | | 
| 2780/3780 enhancement package | ITED2780.LIB | 
| | | 


driver library 


3-4 USER DEFINED LIBRARIES 


If a user written communication protocol and/or driver is to be 
included in the operating system, it must be included in one of 
the following user defined libraries: 


e user defined system likrary 


e user defined driver library 


3.4.1 User Defined System Library 


Table 3-7 presents the user defined system library. 


TABLE 3-7 USER DEFINED SYSTEM LIBRARY 


| User defined system library {| USERSYS.LIB | 
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304.2 User Defined Driver Library 


Table 3-8 presents the user defined driver library. 


TABLE 3-8 USER DEFINED CRIVER LIBRARY 


— a om GF ae om ow GF On On om OE OD @® & @® @& oF Oe @& OD aS OP a G8 © © Ob ® @ OO ow es OO @ & we OO Oe ew ee @ oe 


| LIBRARY DESCRIP TON | LIBRARY NAME | 


| 
| User written drivers } USERDLIB.LIB | 


am OP OD DO ow Ow Oe OO OOM OOO S22 BB FZhe OB eweBeeee @eeweeaeea a 


3-5 MACRO LIBRARIES 


The macro libraries presented in Table 3-9 are 
macro expansion phase of the Sysgen/32 process. 
comprise the Sysgen/32 macro library are listed and explained 


Table 3-10. 


TABLE 3-9 MACRO LIBRARIES 


required 


in 


~~ oP on OF ae ee Dew OS OO OOO Be 2S S28 O82 STS SSMS 2S & @& @ oe o SS eo & aw & oO OF a2 oF = OF OO a 


| | LIBRARY 
| LIBRARY DESCRIPTION ] NAME 

| Hess sssssesesessasssesssse | 
| The Sysgen/32 macre library | SYSGEN32.MLB 

ewiene Greeiuaie” GahieRae She a eg | 
| The macro library containing system | SYSSTRUC.MLB 

{| structures | 

| a ee ee ee ee 

j The basic communication system macro | ITMS.MLB 

{| library (required only if communica- | 

{| tion support is included) { 

rag eue apc waco ae Sa SR a oe 
{| The general driver macro Library | DVRM.MLB 
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the 


The macros that 


in 


TABLE 3-10 MACROS IN SYSGEN/32 MACRO LIBRARY 


| channel control block (CCB) for non | 
! ITAM devices. | 


DCPI | Creates the DCBs and initializes | 

| the DCB fields for non ITAM devices. | 
aw eew we Seems ee wate wen en rows ween ean awa aceon e owas | 
DCBINI Initializes the DCB fields based | 
on default settings maintained in |. 
the macro, and on the information | 
input in the device statement. It | 
calls the particular macros in | 
SYSGEN32.MLB or macros in the other | 
macro libraries needed to create the| 
DCB and CCB for the specified device] 


DEF | Defines storage or constants, | 
| optionally repeating the define the | 
{ specified number of times. | 


DFLIST | Defines a list and generates a | 
{ label and entry based on the para- | 
{| meters fassed. | 


| Generates the device mnemonic i 
| table (DMT). Entries are generated | 
{ using the information in the sysgen | 
{| device statements. | 


| Generates device, directory and | 
{| bitmap leaves; generates required | 
| nodes (Coordination, SELCH, Control-| 
| ler). | 
FLTPINIT Generates external entries (EXTRNS) | 
for the appropriate floating point | 
modules depending on support speci- | 
fied in the FLOAT configuration | 
statement. (The EXTRN for a user- | 
specified module is generated by the] 
Sysgen/32 program. Generates labels | 
and reserves memory for the program | 
Status word (PSW) and register save | 
areaSe | 


wwe anne “SE cee ee ee ee oe 
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TABLE 3-10 MACROS IN SYSGEN/32 MACRO LIBRARY 


(Continued) 

| MACRC | ] 
| CALL | | 
| NAME | FUNCTION | 
| eSsascecsessss se sssrstees sess sess sesssssssessase | 
|} ITAMCCB | Generates and initializes the CCBS | 
| {| for ITAM devices. | 
a eebeviaia oi uiaiaaagiais parce a aasar ae SSensena ane ae 
| ITDC1 | Creates and initializes the device | 
| ITDC2 |} dependent portion of the DCB for | 
|} ITDC3 | ITAM devices. | 
eisaieiee icin nen aaa eel Santee Caen eee 
{| IVTIGEN | Generates the initial value table | 
| { (IVT) from information entered in ! 
| {| the eourrgure tron input file. | 
iste eats nial cen gata icine: EL EI aa | 
| MMDGEN | Generates the mass storage media | 
| | (MSM) or (MMD) device dependent | 
| | portion of the DCB for MSM or MMD | 
| } disks. | 
ae neniearaes enone canine eee nae | 
| MTPI { Initializes the additional DCB | 
| ] fields needed for magnetic tapes | 
[pe cggeie ane ot ces eee 
| SCRDP {| Contains the extended DCB struc- | 
| | tures for card reader/punches. | 
jrece es Gae eee sees ee ERE aa gaan | 
| SLABEL | Used to create a label and an entry | 
| | for the passed parameter. | 
earraoeneE areee Beas ceer ees tae ane peae renee 
| SMCONFIG | Defines the memory configuration j 
| | for Perkin-Elmer 3200 Series pro- | 
| { cessors based on the information in | 
| | the MCONFIG statement. | 
[trie ntsiais castes aicdaein cekanaeen seg ecu aun eure | 
SPDMT | Flags virtual devices in the device | 

| mnemonic table (DMT). | 

ee ee ee owe wee meee meter eer -- | 

SPTINIT Defines and initializes the system 


| { 
| pointer table (SPT); sets the panic | 
{| address and system queue pointer; | 
| generates the ISPT, task control | 
| blocks (TCB), and the TCB table; | 
| generates the journal and pointer | 
| stack. Defines and initializes the | 
| system pointers and tables, and re- | 
| serves memory for system structures. | 


ee a ome SOD eo sees Oe OE ee ee coe co 
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TABLE 3-10 MACROS IN SYSGEN/32 MACRO LIBRARY 


(Continued) 
| MACRO | | 
| CALL i | 
| NAME { FUNCTION 1 
| }— ft  ———2——— | 
| STARTUP | Builds the command stream to run at } 


| {| system startup using STARTUP...eENDS | 
| {| statement input. | 


| TCOMINIT { Generates and reserves memory for | 
| {| the global task common segments | 
| | using TCOM statement input. | 


| VMTGEN | Generates a label and reserves , 
| | space for the volume mnemonic table. | 
Sis deg singe caus aisne tas ace ees Sivaeeaeee | 
| SUP | Used by SPTINIT macro (when gener- | 
{ SREV |} ating the SPT) to update the | 
Aimee {| operating system revision ID. | 


en = ow ae oe www ow ow @ oF ie © oe oe ow @ @ ow © oo oe om ow on ow an a ow © oe oo a @ ae ow ae am oe oe 


3.5.1 Modifying the Sysgen/32 Macro Library 


The following sections detail procedures for making modifications 
to the Sysgen/32 macro library. 


3.5-1-1 Adding Nonstandard Devices 


If a nonstandard device is to be included in the operating 
system, it must be defined in the sysgen device statement and the 
Sysgen/32 macro library must be modified to recognize the device 
code and initialize the appropriate data structures. The library 
containing the user written driver for the device must be 
specified during the link phase of the Sysgen/32 process. 


3.56142 Changing Data Structures of a Supported Device 


If changes are to be made to the data structures of a supported 
device, the appropriate macro in the Sysgen/32 macro library 
(SYSGEN32.MLB) must be modified to reflect the changes. No 
modifications are necessary if only code in the driver module is 
affected. 


If any unresolved FXTRNS exist after all libraries have been 
searched, link displays a warning but attempts to build the 
operating system. The link map should be checked to ensure that 
all external references have been resolved. 
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36 SOURCE LEVEL SYSGEN PROCEDURE 


To include user-written or modified source modules follow these 
sters: 


1-2 Copy the source sysgen parameters from the appropriate file, 
SYSGEN.Mac, to a backup file using 0S/32 Copy. 


Ze Copy the system source module library to a backup file using 
0OS/32 Copy. 


3. Change the source parameters in SYSGEN.MAC to include or 
exclude the desired options. 


4“. If the name of the modified module differs from the original 
module name, the PROG, ENTRY, and EQUATE statement labels 
must be changed to the modified module name. The SOSPROG 
macro can be used to change the original module name to the 
modified module name. 


5. The following assignments must be made to expand the internal 
operating system macros using the CAL Macro/32 processor: 


AL usermoduleeEXP,IN,80 
L .BG,MACRC32 

T BG 

AS 1,usermodule.CAL 

AS 2,usermodule.EXP 

AS 3,NULL: 

AS 7,SYSGEN.MAC,SRO 

AS 8,SYSSTRUC.MLB,SRO 
AS 9,SYSMACRO.MLB,SRO 
AS 10,ITMS.~MLB,SRC 


To assemble module EXSV, lu 11 must be assigned to 
SYSMAC32.MLB. To assemble module FMS7, lu 11 must be 
assigned to SYSMAC32.MLR, and lu 12 must be assigned to 
DVRM«MLB. 


NOTE 
If user-written macros are to be included 
in the expansion, assign lu 11 to the 
appropriate macro library and start 
MACRO32 by entering: 
ST ,ML=(8,9,10,11) 
When assembling a driver from the general 
purpose driver library, assign lu 11 to 


DVRM-eMLB and Start MACRC32 by entering: 


ST »ML=(8,9,10,11) 
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Assemble the modified source module using CAL/32 with the 
CROSS and SQUEZ opticns specified. (The SQUEZ option is 
required to assemble the floating point module.) 


AL usermodule.OBJ,IN,126 
L .BG,CAL32,55 

T BG 

AS 1,usermodule.EXP 

AS 2,usermodule.OBJ 

AS 3,PR: 

TE 5,1N,256//4 
AS7,SYSGEN.MAC,SRO 

ST ,CROSS,ERS,SQUEZ=99 


If the name of the user-modified object module is the same as 
the original module name, replace the original object module 
in SYS.LIB with the medified module using the 0S/32 Library 
Loader. In this example, SYSMODennn is the module being 
replaced in SYS.LIB. 


LO .«BG,LIBLDR 

TA BG 

AL newsys.LIB,IN 
AS 0,NULL: 

AS 1,SYS-eLIB 

AS 2,newsyseLIB 
AS 3,CON: 

AS 4,usermod.OBJ 
AS 5,CON?: 


-BG>TAB 1,3 
eBG>RW 1 
~BG>TAB 4,3 
eBG>RW 4 
eBG>DUPE 1,2 sysmod.nnn 
eBG>SCOPY 4, 

~BG>COPY 1, 
eBG>DUPE 1, 
eBG>RW 2 
e-BG>TAB 2,3 
eBG>END 
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8. If the original and the modified module names differ, change 
the PROG, ENTRY, and EQUATE statements in the module to 
indicate the new name and add the modified module to the 
system library. 


LO .BG,LIBLDR 

TA .BG 

AL newsys-LIB,IN,126 
AS 1/SYSeLIR 

AS 2,newsyseLIB 

AS 3,CON: 

AS 4&,usermod.C3J 

AS 5,CON: 


~BG>TAB 1,3 
~BG>RW 1 
~BG>TAB 4,3 
eBG>RWEL 4 
~BG>DUPE 1,2 
~BG>COPY 4,2 
~BG>RW 2 
~BG>TAB 2,3 
~BG>END 


9. Pertorm a sysgen using the modified systea library. Include 
the MODULE.~.-ENDM statements to include the modified module 
if the module name changed. 


3.7 SOURCE LEVEL SYSGEN EXAMPLE 


To change the variable time delay (SGN.DLAY) option affecting the 
system source module EY¥IN.MAC and replace the system object 
module EXIN.F13, follow these steps: 


1. See Table 3-3 for the scurce module EXIN.MAC affected by the 
sysgen variable SGN.DLAY. 


2- Copy EXINeMAC, the affected source module, to a backup file 
with the new filename, NEWEXIN.MAC. The object module 
variation EXIN.F13 now in the system library must be changed 
and assembled to generate a new variation, and be replaced 
with the new variation. 


3. Change the option variables in the SYSGEN.MAC file to: 


- SGN.ITAM 


it 
fo) 


u 
~ 


- SGN.DLAY 
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5. 


6-6 


The communications and Perkin-Elmer 3200 Series processor's 
sysgen variable settings generate the object module variation 
EXIN.F13. A value of 7 is selected for a time delay of 7 
secondse Communications support is not. desired, so 0 is 
entered. 


Use the EDIT commands tc change the source sysgen options in 
the SYSGEN.MAC file: 


LO .BG,EDIT32 
TA «BG 
ST ,C=CONs 
eBG>GET SYSGEN.MAC 
oBG>T /SGN.ITAM/ 
21 SGN.ITAM EQU 1 
eBG>CH / 1/,/ OF 
21 SGN.ITAM EQU 0 
eBG>TYPE/SGN. DLAY/ 


26 SGN.DLAY EQU a 
eBG>CH/5/,/7/ 

26 SGN.DLAY EQU 7 
«BG>SAVE NEWSGN.MAC 
e«BG>END 


Make the following assignments to expand the internal 
operating system macros using the CAL Macro/32 processor: 


LO .BG,MACRO32, 20 

TA «BG 

AL EXIN.EXP,IN,80/4 
AS 1,NEWEXIN. MAC 

AS 2,EXIN.EXP 

AS 3,NULL: 

AS 7,NEWSGN.MAC,SRO 
AS 8,SYSSTRUC.MLB,SRO 
AS 9,SYSMACRO.MLB,SRC 
AS 10,ITMS.~MLB,SRO 

ST ,-ML=(7,8,9,10) 


Assemble the user-modified EXIN.EXP module using CAL/32: 


LO .BG,CAL32,55 

TA .BG 

AS 1,EXIN.EXP 

AL EXINF13.0BJ,1N,126 
AS 2,EXINF13.0BJ 

AS 3,FR: 

TEMP 5,IN,256//4 

AS7, NEWSGN.MAC,SRO 

ST -CROSS,SQUEZ=99,ERS 
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7. The assembled EXINF13.0BJ module replaces the module EXIN.F13 
in the system library. Execute these commands: 


LO .BG,LIBLDR 

TA .BG 

AL NEWSYS.LIB,IN,126 
AS 1,SYS.LIB 

AS 2,NEWSYS.LIB 

AS 3,CONs 

AS 4,EXINF13.0BJ 

AS 5,CON: 


eBGOTAB 1,3 
eBG>TAB 4,3 
»~BG>RW 1 
eBGORW 4 
e-BGOLUPE 1,2 
eBG>COPY 4,2 
eBG>FIND 1 
eBGSLDUPE 1 
eBG>RW 2 
»BG>TAB 2,3 
»BG>END 


8. Perform a sysgen using the modified system library. 
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CHAPTER 4 
STANDARD OS/32-SUPPORTED DEVICES 


4.1 INTRODUCTION 


OS/32-supported devices and device characteristics are described 
in this chapter. These characteristics must be defined in the 
Sysgen/32 device statements when a device is included in the 
Operating system. Nonstandard devices supported by user-written 
drivers must use reserved device codes and also must be defined 
in the device statements to be included in the system. 


4.2 OS/32-SUPPORTED LOCAL AND REMOTE DEVICES 
Table 4-1 lists, by local and remote device codes, the 
OS/32-supported devicese Table 4-3 lists the categories (card 


reader/punch, local video display unit (VDU), etc.) of 
OS/32-supported devices and their local and remote device codes. 


TABLE 4-1 DEVICE CODES FOR O0S/32-SUPPORTED DEVICES 


LOCAL | REMOTE | . | | 
DEVICE | DEVICE | | | 
CODE | CCDE | DEVICE TYPE | INTERFACE | 
SSS 2S SSS SSS SSS SS SS SSS SS VS SBS SSSSSHE SSS = SRSSSSSSSVRSSssSseasesse2es=== | 
0-15 | | Reserved | | 
16 | | Model 33 Teletype (TTY) key- | 
| {| board/printer | CLI | 

17 | } Model 35 (TTY) keyboard/printer| CLI { 
18 | | Nonediting VDU { CLI, CLCM | 
aa | | { RS232C | 

19-20 | {| Reserved ] { 
21 | | Carousel 15. 30, 35, 80- | | 
| | character line { CLI a 

22 | { Carousel 15, 30, 35, 132- | | 
| {. character line { CLI | 

23 | | Model 1100 VDU | CLI, CLCM | 
24-33 | | Reserved | | 
34 {| 147 | Nonediting VDU 2- or 8-line | RS232C, | 
| | | CLCM, CLI | 

35 | {| Reserved | | 
36 | 147 | Graphic display terminal 2- or | RS232C, | 
| { 8-line } CLCM | 
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TABLE 4-1 


DEVICE CODES FOR OS/32-SUPPORTED DEVICES (Continued) 


— = oe ee we ee ee ee ee ae oe ae oe ee oe oe we ee ee os ee oe oe ee ee ewe es ee we oe ee ee ee we ee ee ee ve ee es 
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37 


38 


85-95 


DEVICE 


ee a er i ee ee ee eee 


DEVICE TYPE 
Carousel 300 2- or 8-line 


Carousel 300 with electronic 
forms control 2- or 8-line 
Model 550 and 1100 VDU 2- or 

8-line 

Reserved 

1-5Mb HPT 

160Mb, fixed 

1.5 HPT 

2e5Mb disk, fixed 

2-5Mb disk, removable 

5Mb disk, fixed 

5Mb disk, removable 

YOMb disk, removable 

67Mb disk, removable 

256Mb disk, removable 
Floppy disk 

68.5Mb disk, fixed 

1.5Mb HPT 

67Mb disk, fixed 

16Mb disk, removable 

16Mb disk, fixed 

UBMb disk, fixed 

80Mb disk, fixed 

675Mb disk, fixed 

800bpi magnetic tape 
800/1600bpi magnetic tape 

Intertape cassette 

Keserved 

6250/1€00/800bpi STC magnetic 
tape 

6250/1600/800 BPI STC 

Mag tape (halfword mode) 
6250/1600/800 EPI TELEX 
Mag tape (halfword mode) 

Reserved 

High-speed paper tape reader/ 
punch 

Model 33 TTY reader/punch 
Model 35 TTY reader/punch 
Carousel 35 with paper tape 
reader, 80-character line 


Carousel 35, card reader, 132- 


character line 
Reserved 


| INTERFACE 


RS 232C, 
CLCM, CLI 
RS232C, 
CLCM,CLI 
RS232C, 
CLCM,CLI 


CLI 


CLI 


——- cue ase GOee comm OO qo oem quee cme eee ene comm come ER ere come oe eee ames Ce ee eee eee eee Gee eee eee eee ee ee ee cee es ee eee ees ee eee ee ee eee ee oo oe 
—— euee ese aoe Se eee ee ee eee ore ee ee ce ee ee ee ee ee ee ee ee ee eee eee eee a ee ee ee ee eee ee ee ee eee ee ee ee owe oo oe 
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TABLE 4-1 


DEVICE CODES FOR OS/32-SUPPORTED DEVICES (Continued) 


ee She EP ee OD OD OR Om ED EO em Ore OF) ED ED Om 8) OP 2 om em OD @® ce Oe GP Oe OF aD OD OD OF ae 8 8 ee oe Om ee ee a OD ee ed > ED OO on ee Om ee ee ee Oe Oe ee ee oe oe 
A See Te Gee LS ee Sie SNP UD WS cae CED SEP GEE ate ENS SER Oe Gee Gee ae See ew Ge ee Ue aes ee SES ED ee GES GED GE Ge OED OR SE en ne DD ee a> ae ED 0 ae Gee GS am an axe GS one on aa ans =D Gn Sue ae Gun mone 


98 


99-103 
104 


105 
106 
107-111 
112 
113 


4114 
116-127 


140 
141-143 


18 


= 
uy) 
aN 
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144 


145 
146 


147 


148-155 
156 
157 
158 
159 
160 


ROO 


with software 
029 card encoding 
with hardware 
029 card encoding 
with software 
026 card encoding 


Card reader 
translate, 

Card reader 
translate, 

Card reader 
translate, 

Reserved 

Card reader, high speed, 
card encoding 

Card reader/punch, 
encoding 

Card reader/punch with print 
option separate, 029 card en- 
coding 

Reserved 

Low-speed line printer 
Medium-speed line printer 
High-sreed line printer 
Reserved 

8-line interrupt module 
Digital multiplexor controller 

Reserved 

Real time analog system with 
internal clock 

Real time analog system with 
user-supplied external clock 
Mini I/O analog input 

Mini I/O analog output 

Mini I/C digital 

Reserved 

Asynchronous communications 
line 


029 


029 card 


Remote line printer 

SIGMA 10 terminal (communica- 
tions 

Nonediting VDU (communications) 


Reserved 

Model 1200 VDU (communications) 
Model 1250 point-to-point VDU 

Model 1250 multidrop VDU 

Reserved 

Binary synchronous communica- 
tions line on 201 (DSA) 


Line 
Driver 
Only 


CLCM 


CLCM 
CLCM 
CLCM 


Line 
driver 
only 


RS232C, 


TABLE &-1 DEVICE CODES FOR 0S/32-SUPPORTED DEVICES (Continued) 


LOCAL {| REMOTE | { { 
DEVICE | DEVICE | | 
CODE { CODE | DEVICE TYPE | INTERFACE | 
SSS S Tere STS SSS SS SSMS SS SS SVS SSS SVS SSS SS SS SST SSS SSS SSS SSS SSeS See Soo | 
| 161 | IBM 3780 remote job entry | | 
| | (RIE) emulation on 201 DSA | } 
| | (Ccommunications) | | 
| 162 ] IBM 2780 remote job entry | | 
| { CRJE) emulation on 201 DSA { | 
| { (conmunications) | | 
| 163 | Binary synchronous processor- | { 
| | to-precessor link on 201 DSA | | 
| } (communications ) | | 
| 164-167 | Reserved | | 
{| 168 | Binary synchronous communica- | Line | 
| | cations line on quad syn- | driver | 
| | chronous adapter (QSA) | only | 
{ 169 | IBM 3780 remote job entry ] | 
| {| (CRJE) emulation on QSA (com-§ {| | 
| | munications) | | 
| 170 | IBM 2780 remote job entry | | 
| { (RJE) emulation on QSA (com- | | 
| | munications) | | 
{ 171 {| Binary synchronous processor~ | | 
| | to-processor link on QSA | | 
| | (communications) | | 
} 172-191 | Reserved for ZOLC and 3270 | | 
| | Emulator support j j 
{| 192 | DMA I/C subsystem (DIOS) (com- | | 
| } munications) | | 
} 193-223 | Reserved { | 
| 224-239 | Reserved for CAMAC access | | 
{ | method | | 
{ 240-254 | Reserved for user-written | | 
| | drivers | | 
{ 255 { Null device | | 
LEGEND 
CLI = Current loop interface 


CLCM = Current loop communications multiplexor 


RS232C = programmable asynchronous line system (PALS), 
programmable asynchronous single line adapter (PASLA), 


2- or 8-line communications multiplexor 
NOTES 
Ve CLI is equivalent to TTY interface. 


2e Device cecdes 172 to 185 are not 
Sysgen/32-supported devices. 
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TABLE 4-2 CATEGORIES OF OS/32-SUPPORTED DEVICES 


3 
eS 
a ©] 
tes 


reader 


Card 
reader/ 
punch 


TTY 
reader/punch 


keyboard 
printer 
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DEVICE 


With software 
translate, 
029 card encoding 


With hardware 
translate, 
029 card encoesug 


With eRe tuacs 


translate, 
026 card encornd 


High-speed, 
029 card encoding 


029 card encoding 
With print option 


separate, 
029 card encoding 


Carousel 35 with paper 
tape reader, 
8O0-character line 


Carousel 35 card reader, 
132-character line 


Model 33 (CLI) 


Model 3£ (CLI) 


Carousel 15, 30, 35, 
80-character line (CLI)) 


Carousel 15, 30, 35, 
132-character line (CLI) 


Model 1100 VDU (CLI) 


LOCAL 
DEVICE 
CODE 


REMOTE 
DEVICE 
CODE 
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TABLE 4-2 


CATEGORIES OF OS/32-SUPPORTED DEVICES (Continued) 


| LOCAL | REMOTE | 
| DEVICE | DEVICE | 
| CODE | CODE | 


High-speed 
paper tape 
reader/punch 


Line 
printer 


Tape 
cassette 


se wees eee ee ene eB @wves Beene eee 


Intertape 


Magnetic 
tape 


800bpi 


6250/1600/800 BPI STC 
Halfword mode 


6250/1600/800 BPI TELEX 
Halfword mode 


160Mb, fixed 


2-5Mb disk, fixed 


2°e5Mb disk, removable 


5Mb disk, fixed 


5Mb disk, removable 
“UOMb disk, removable 
67Mb disk, removable 


256Mb disk, removable 
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TABLE 4-2 


CATEGORIES OF OS/32-SUPPORTED DEVICES (Continued) 


2 => an as am ap oe om aw om 6D ah &® om a © Co am 6 a om aw Fo Oe  @ & 6% oD on © oF 8 © © @ @® @& oF @ 3 OF oe oe Oe Ow we Ow oe @ ww we we we 


Disks 
(continued ) 


68.5Mb ape ke. fixed 


1e-5Mb disk, HPT 


LOCAL 
DEVICE 
CODE 


REMOTE 
DEVICE 
CODE 


I 

| Local Nonediting VDU (CLCM) 

{| VDU (RS232C) 

I 

| Graphic display 

| terminal (CLCM) 

| (RS232C) 

| 

| Carousel 390 (CLCM) 

| (RS232C) 

i 

| Carousel 300 with 

| electronic forms 

| control (CLCM) (RS232C) 

| 

| Models 550 and 1100 

| VDU (CLCM) (RS232C) 

ke ea a | 
{| 8-line 

{ interrupt 

| module 8-line aprerrant module 

[oeceier cease Reon E Brac al Sn a 
} Digital Digital suitipiexer 

| multiplexor controller 

eels Slain RR Gt ae a ! 
| Conversion Real time analog system 

{| equipment with internal clock 
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TABLE 4-2 


CATEGORIES OF OS/32-SUPPORTED DEVICES (Continued) 


LOCAL | REMOTE | 
DEVICE | DEVICE | 
| 


Conversion 
equipment 
(continued) 


Analog I/0 
Controller 
Ligital I/0 


Controller 


Communications 
Devices 


| Real time analog system 
| with user-supplied 


{| Asynchronous communica- 
| tions Line, line driver 
| only 


| wea we ee = ee we es 2 we wee = a @ Pew ererwe ere es we wwe eee oe | 


{ Remote line printer 


| Nonediting VDU (CLI) 


| Models £50 and 1100 VDU 
| (CLI) 


| Model 1250 point-to- 
{ point VCU 


| Binary synchronous on 
{ 201 DSA, line driver 
| only 


| 
{ IBM 3780 RJE emulation 
{ on 201 CSA 


| IBM 2780 RJE emulation 
J on 201 CSA 


— 


{| Binary synchronous 
{| processcr-to-proecessor 
| on 201 CSA 


CODE | CODE 
| | 
| { 
137 | | 
138 | | 
139 | | 
| | 
140 { | 
{ | 
{ | 
| 144 
| 145 | 
{| 1486 
18 1 147 
| | 
39 | 147 | 
{ 155 | 
| 156 | 
| { 
{1 157 | 
1 158 | 
i | 
| | 
| 160 | 
| \ 
{ 161 | 
{ | 
| 152 | 
| | 
| | 
| 163 
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TABLE 4-2 CATEGORIES OF OS/32-SUPPORTED DEVICES (Continued) 


| | } LOCAL | REMOTE | 
{ | 7 | DEVICE | DEVICE | 
| 


| TYPE | DEVICE {| CODE | CODE 

STS SS SSS SSS8 SS SS SSS SS SSS VATS SSVSSISSTSSSVSSSSSSSsSSQqQqa=ssacrsSa22zeze2=- | 
Communications | Binary synchronous on | | | 
devices {| QSA, line driver only | { 168 | 
(continued) aa ca ie aa ao a a al | 


{ on QSA | | 169 | 


| on QSA | | 170 | 
| Binary synchronous { | { 
| processcr-to-processor ! | | 


| link on QSA | 171 


ame aaiag aces Sea ee eee | 
| DMA I/O Subsystem (DIOS) | } 192 | 
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4.3 DEVICES USING CURRENT LOOP INTERFACE (CLI) 

Devices using CLI can be used as the console device. These 
devices connected to the CLI can be canfigured in the systems 

e Carousel 15, 30, 35 

@ Carousel 300 

e Model 33 TTY 

@ Model 35 TTY 

e Nonediting VDU 

e Model 550 

@ Model 1100 

When the paper tape reader/rpunch and keyboard/printer features of 
the TTY and carousel devices are both supported, a shared-busy 


condition exists, since these devices are configured at the same 
addreSSe 
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NOTE 
If the reader/rgunch feature is supported 
by an (ASR) TITY console device, the 
reader/punch feature must not be assigned 
to a user task. 
If a carousel supports parer tape, it can 


only support the paper tape reader 
feature. 


Examples: 


TTY13:,2,016,CONS *Mcdel 33, console device 
TRP1:,2,081 *Reader/punch, same device 


4.4 DEVICES USING STANDARD RS232C INTERFACE (PALS, PASLA, 
2- or 8-LINE COMMUNICATIONS MULTIPLEXOR) OR CURRENT LOOP 
COMMUNICATIONS MULTIPLEXOR (CLCM) 

Devices using the standard RS232C interface or CLCM can be used 

as the console device. The following devices connected to the 

Standard RS232C interface or CLCM can be configured in the 

systems: 

e Nonediting VDU 

e Graphic display terminal 

e Carousel 300 

e Carousel 300 with electronic format control (EFC) 

@e Model 550 (nonediting) VIU 

@e Model 1100 (nonediting) VDU 

@e Model 1200 (editing) VDU 

@e Model 1250 (editing) VDU 

Because the editing features of Models 1200 and 1250 are not 

currently supported by the VDU driver, both models must be 


configured as nonediting VDU. Communications supports the 
editing features of Models 1200 and 1250. 
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CAUTION 


Do not use Models 1200 and 1250 with the 
editing feature as the console device, as 
data written to the device can lock the 
keyboard. 


The default strapping for PALS, PASLA, 27 and 8-line 
communications multiplexor, and CLCM is: 


e The clocks are strapped to a baud rate between 110 and 9600. 
A clock is selected when the device begins an I/O operation. 


e The function switches for Model 1100, 1200, and 1250 should be 
set for even parity. All other devices should be set for no 
parity.e 


e The interface must be strapped fiull duplex, disable CARR 
status, disable DSRDY status, and disable CL2S for nonediting 
VDU, graphic display terminals, and Carousel. For the Models 
1100, 1200, and 1250 VTUs, the interface must be strapped full 
duplex, enable CARR status, enable DSRDY status, and enable 
CL2S status. 


4.5 INTERTAPE CASSETTES 


The two cassettes located in a transport are interlocked in the 
hardware, causing a shared-busy condition. 


Examples 
CAS1:,45,066 *Two cassettes on 
CAS2:,55,066 *same transport 


4.6 CARD READERS 


These card readers can be configured in the system: 


e Card reader 029 with software code translation 
e Card reader 029 with hardware code translation 


e Card reader 026 with software code translation 
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There is an additional feature of the 026 and 029 card reader 
drivers that can be included in the system at sysgen time. The 
driver can translate the Hollerith code into EBCDIC instead of 
ASCII code. This feature can he included by specifying the 
following translate tables in the device statement: 


e INITRE26, which converts all 026 card reader codes directly to 
EBCDIC representation in memory 


@ INITRE29, which converts all 029 card reader codes directly to 
EBCDIC representation in memory 


Example: 
CR29:,04,96 *Standard card reader, software translate, 029 
card encoding 
CRHW:,04,97 *Card reader, hardware translate, 029 card 
encoding 
CR26:,04,98 *Standard card reader, software translate, 026 


card enccding 
4.7 CARD PUNCHES 


These card punches can be configured in the system: 


e High-speed 029 card encoding 
e Card reader/punch (interpreting) 


e Card reader/punch 029 card encoding with print option 


As supplied, these devices translate 029 Hollerith 
code to/from ASCII. There is an additional feature of the card 
punch and card reader/punch that can be included in the system. 
Optionally, the devices can translate 026 Hollerith 
code to/from ASCII, 026 Hollerith code to/from EBCDIC, or 029 
Hollerith code to/from EBCDIC. These features can be included by 
referencing the following translate tables in the device 
statement: 


@ INITPA26 or INITRA26, which converts all 026 card codes 
directly to ASCII representation in memory 


@e INITPE29 or INITRE29, which converts all 029 card codes 
directly to EBCDIC representation in memory 


e@ INITPE26 or INITRE25, which converts all 026 card codes 
directly to FBCDIC representation in memory 
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Example: 


CP:,7,104 *High-speed card punch 
CRP:,8,105 *Card reader/nunch 
CRPS:,9,106 *Card reader/punch with print separate 


4.8 LINE PRINTERS 


These line printers can be configured in the system: 


e 60-200 lines per minute (LPM) printer 
e 300 LPM printer 
@e 600, 1000 LPM printer 


@e Remote line printer 


NOTE 


Full vertical forms control (VFC) is 
supported by the Perkin-Elmer local 
printer drivers only. 


Examples 


LPR1:,62,112 *Low-speed printer (60-200 LPM) 
LPR2:,63,113 *Medium-speed printer (300 LPM) 
LPR3:,72,114 *High-sreed printer (600, 1000 LPM) 


&.9 HIGH-SPEED PAPER TAPE READER/PUNCH 

High-speed paper tape reader/punches can be configured in 
system. 

Example: 


PRTP:,13,80 *High-speed paper tape reader/punch 


4.10 MAGNETIC TAPE CONTROLLERS AND TAPES 


the 


Magnetic tape controllers are specified in the controller option 
of the device statementse A magnetic tape controller supports 


from one to four transports. 
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The device statement for the tapes must identify the tapes for 
each controller. Fach tape requires a device statement that 
allows more than one tape to be active at one time. The 
following magnetic tapes can be configured in the systems 

e 800bpi magnetic tapes 

e 1600bpi magnetic tapes 

e 1600/800bpi dual density magnetic tape drives 

@ 6250bpi magnetic tapes 

e Halfword mode controller 

e TELEX tape device 

The 6250 tape drives may require extended direct memory access 


(EDMA) bandwidth coordinatione The 6250 tape drives can run with 
gaps or in gapless mode. 


Example: 
MAG1:,85,64,CONTR=0,SELCH=FO *Tapet (800 bpi) 
MAG2:,95,64, CONTP=0,SELCH=FO *Tape2 (800 bpi) 
MAG33:,C5,65,CONTR=1,SELCH=FO *Tape3 (1600 bpi) 
MAG4:,D5,65,CONTR=1,SELCH=FO *Tape4Y (1609 bpi) 
MAG5:,80,68,SELCH=F0O,CONTR=2 *TapeS (6250 bpi) 
MAG6:,90,68,SELCH=FO,CONTR=2 *Tape6 (6250 bpi) 


4.11 DISKS 


All Perkin-Elmer supported disks have one disk volume per disk 
drive, except for the 10Mb disk (M46-416), which is composed of 
two 5Mb disk volumes, and the 58.5Mb disk, which is composed of 
a 1e5Mb disk and a 6€7Mb disk. 


Three algorithms are available for scheduling I/0 queued to a 
disk: priority, first-in/first-out (FIFO) and C-SCAN (seek 
optimization). The C-SCAN algorithm is supplied as a default and 
is used to produce the highest throughput on the disk by reducing 
the number and range of seek operations. It includes an 
adjustment to prevent one task from queuing many consecutive 
I/Os. If a task request is queued ahead of all other requests, 
and the current I/0 is being executed for this same task, then 
this request is scheduled on the next scan of the arm. 
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The priority and FIFO algorithms are selected by specifying the 
QUEUE option in the device statement. For priority scheduling, 
DISKQ is changed to COMQ. For FIFO, it is changed to COMFIFO. 
Priority schedules by calling task priority and then FIFO within 
each priority level. FIFO schedules without regard to priority 
or disk position. . 


A second available option is the elimination of the EDMA 
coordination overhead in systems that do not require EDMA 
coordination. The field LCB.EDMA should be left at zero. This 
is accomplished in the CCBINI macro in the macro library 
SYSGEN32-MLB by omitting EDMA=SEEKCHK. 


4.11.1 Moving-Head Disks 
A moving~head disk controller supports from one to four disk 
drives. The device statements for the disks must identify the 


SELCH and controller address. 


The following disks can be configured in the system: 


@ 2.5Mb, fixed 
@ 2.5Mb, removable 


@e 5Mb, fixed 
Composes a 10Mb disk 
e@ 5Mb, removable 


@e 4OMb, removable 


The 10Mb disk is composed of two 5Mb disks. These two disks 
share the same drive, causing a shared-busy condition. Two 
device statements must be specified for a 10Mb disk. The 
shared-busy conflict is resolved by Sysgen/32 based on the device 
code/device address. 


Examples 


DSC1:,C6,51,SELCH =FO0,CONTR=B6 *Removable 
DSC2:,C7,50,SELCH=FC,CONTR=B6 *Fixed 
DSC3:,D6,51,SELCH=FO,CONTR=B6 *Removable 
DSC4:,D7,50,SELCH=FO,CONTR=B6 * Fixed 


DSC1 and DSC2 have a Shared-busy condition, as do DSC3 and DSC4&. 
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4.11-2 Mass Storage Media (MSM) Disks 


These disks can be configured in the systems 


@e MSM300 256Mb, removable 
@e MSM80 57Mb, removable 


@e MSM80 67Mb, fixed 
Composes a 68.5Mb disk 
e MSM80 HPT 1.5Mb, fixed 


@e MSM80 HPT 68.5Mb, fixed and removable 
@e MSM1.5 HPT of 675, fixed 


@e MSM160, fixed 


The 68.5Mb MSM HPT disk is composed of a 1-5Mb fixed-head disk 
and a MSM 67Mb fixed disk. 


If the disk drive requires dual port support, the dual port 
option should be specified in the device statement. The driver 
will treat alternate channel busy conditions from a single port 
drive as an error condition. 


I/C error recording is supported for MSM disks only. Tables 4-1 
and 4-2 contain the device codes for MSM disks. 


4.1123 Direct Memory Access (DMA) Coordination Nodes 


It iS possible to configure DMA devices whose total bandwidth 
would exceed the capacity of the EDMA bus. To prevent the 
resultant data overruns and inefficient operation, coordination 
of EDMA activity can be configured by using the EDMA node. 
Generally, the 6250bpi, 125ips, and the MSM disks are considered 
for EDMA coordination. Only when present in extreme numbers on 
the Model 7/32 processor would the slower tapes and disks be 
considered for coordination. 


If the number of channels is greater than the number of 
simultaneous data transfers allowed in the system, a DMA 
coordination node must be configured. However, if the number of 
channels is less than or equal to the number of simultaneous data 
transfers allowed, no coordination statements are required. 


DMA coordination is specified in the COORDINATION statement. 


4-16 48-037 FOO ROO 


Examples: 


DSC1:,FC,53,SELCH=FO,CONTR=FB *67Mb (MSM80) disk 
DSC2:,EC,53,SELCH=F1,CONTR=EB *67Mb (MSM80) disk2 
Mag1:,85,68,SELCH=F2,CONTR=0 *6250bpi, 125ips magnetic 


tape driver 
COORDINATION=TRANSFER=4,SELCH=(FO,F1, F2) 


4.11.4 Floppy Disk Subsystems 


A floppy disk subsystem consists of one controller with one to 
four spindles. The controller is transparent to the usere All 
spindles share the same controller, causing a Sshared-busy 
condition. The shared-busy conflict is resolved by Sysgen/32 
based on the device address configuration described in Section 
2e2e 116 


The device statement for the disk has a device mnemonic 
associated with the drive only when the disk is marked offline. 


Two algoritRms are available for scheduling I/0 queued to a 
floppy disk: priority and FIFO. 


The priority algorithm is selected by specifying the QUEUE option 
in the device statement. Fer priority scheduling, COMFIFO is 
changed to COMQ. Priority schedules By calling task priority and 
then FIFO within each priority level. The default algorithm is 
FIFO. FIFO schedules without regard to priority or disk 
position. 


A second option available is elimination of the EDMA coordination 
overhead in systems that do not require EDMA coordination. The 
field DCB.EDMA should be left at zero. This is accomplished in 
the DCBINI macro in SYSGEN32.MLB by omitting EDMA=SEEKCHK. 


If there is more than cone floppy disk subsystem in the system, a 
DMA coordination node must he configured above the subsystems it 
controls. If a DMA coordination node is not defined, 
intermittent I/0 errors, loss of data, or system failure can 
occure Although the floppy disk is nat a DMA device, it uses the 
Same coordination methods to operate within the bandwidth 
limitations of the controller. 


The device statement fer each spindle has a: 
@ device mnemonic associated with the spindle, and a 


e spindle number (0, 1, 2, or 3) specified in the SPINDLE option 
of the device statement. 
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Examples: 


FLP1:C1,055,SPINDLE=0 *First floppy disk spindle 
FLP2:C1,055,SPINDLE=1 *Second floppy disk spindle 
FLP3:C1,055,SPINDLE=2 *Third floppy disk spindle 
FLP1:C1,055,SPINDLE=0 *First spindle for subsystem! 
FLP2:C1,055,SPINDLE=1 *Second spindle for subsystem 
FLP3:C1,055,SPINDLE=2 *Third spindle for subsystem! 
FLPA:C2,0£55,SPINDLE=0 *First spindle for subsystem2 
FLPB:C2,055,SPINDLE=1 *Second spindle for subsystem2 


COORD DEV=(FLP1,FLP2,FLE3,FLPA,FLPB),TRANSFER=1 


4.12 8-LINE INTERRUPT MODULE 


Each 8-line interrupt module must be defined by a device 
statement. Trap generating device (TGD) support must be included 
in the system at sysgen time for an 8-line interrupt module. 


Examples 


LINO:,20,128 
LIN1:,21,128 
LIN2:,22,128 
LIN3:,23,128 
LING:,24,128 
LIN5:,25,128 
LIN6:,26,128 
LIN7:,27,128 


4.13 SYSGENING A SYSTEM WITH A COMMUNICATIONS MULTIPLEXOR 


The communication multiplexor (COMM MUX) interfaces a 
Perkin-Elmer processor system, via a multiplexor bus, to various 
device controllers. It is available in the 2-line version and 
the 8-~-line version. Each line can be strapped for one of four 
Groups, with each group containing four program-selectable clock 
rates. The COMM MUX baud rate is made compatible to the device 
by selecting the clock that matches the desired baud rate. The 
selected clock is specified by the CLOCK option of the device 
statement. see Table 4-3. 
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TABLE 4-3 BAUD RATES WITHIN AN 
INSTALLED GROUP 


| STRAP | BAUD | | 
} OPTION | RATE {| CLOCK | 
| bf — PS | 
| Group 1 | 50 { XA | 
| | 110 | XB | 
{ ! 1 800 | xc | 
| } 2 400 #£4| XD | 
[pose renenehereee cease esse 
| Group 2 | 75 | XA | 
| { 134.5 | XB | 
| { 2 000 {| xc { 
| { 3 600 | XD | 
reac ghia aaa cites ace enectr aecae ] 
{| Group 3 | 150 | XA | 
| | 600 | XB | 
| 1 4 800 j xc | 
| | 9 660 | XD | 
[Sets Sees S oe re see es ae eee = 1 
| Group 4 | 300 {| XA | 
| { 1 200 | XB | 
| | 7 200 {| xc } 
| { 19 200 {| XD | 


&.14 CONVERSION EQUIPMENT CONTROLLER 

These conversion equipment controllers can be configured in the 
system: 

@e Real time analog system 

e Analog input controller 

e Analog output controller 


e Digital I/0 controller 


Examples 
RTAS:,83,136 *Real time analog systen 
AIC: ,88,138 *Analcg input controller 
AOC: ,98,139 *Analog output controlleri 
A0C23:,99,139 *Analog output controller2 
PDIC:,A9, 140 *Digital input controller 
DOC: ,A8,149 *Digital output controller 
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| CHAPTER 5 
SAMPLE SYSGEN/32 SESSIONS 


5-1 INTRODUCTION 


This chapter is presented to aid the less experienced user 
through the initial Sysgen/32 session. It is assumed that the 
user has read the previous chapters (Chapter 1 in particular) in 
this manual before attempting to use Sysgen/32. This chapter 
identifies three general situations, and then presents a sample 
Sysgen/32 session that can be used for each situation. One of 
these situations should apply to a user about to use Sysgen/32 
for the first time. The sample Sysgien/32 sessions presented are 
not the only way Sysgen/32 can be used in these situations. As 
the user becomes more familiar with the Sysgen/32 process, these 
samples need not be used. However, for the first-time user they 
do provide an easy to follow procedure for using Sysgen/32. 


5.2 SYSGEN/32 STARTUP SITUATIONS 


When the user iS prepared to perform a sysgen, one of the 
following three situations will likely exist: 


e A configuration input file has been previously created and now 
must be processed. 


e No previously created configuration input file exists. The 
user wishes to create a configuration input file in the 
conversational mode and then process it. 


e No previously created configuration input rile exists. The 
user wishes to create a configuration input file in the 
interactive mode and then process it. 


In each situation, the user must first load and then start the 
Sysgen/32 program using the system LOAD and START commands, 
respectively. The following three sections provide a sample 
Sysgen/32 session for each of the three situations described 
abovee The user should note that these are sample Sysgen/32 
sessions and the user is not required to use these procedures in 
every case. 
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5.2-1 Processing a Previcusly Created Configuration Input File 


The following commands will load and start the Sysgen/32 program 
and process a previously created configuration input file: 


*LCAD SYSGEN32 
*START, INPUT=FIGUR1.SYS, OUTPUT=MACRO1.MAC, LIST=PR: 


~SYSGEN/32 ROO-00 


When these commands are entered, the configuration input file 
(FIGUR1.SYS) is processed by the Sysgen/32 program in batch mode. 
The macro calls generated by the Sysgen/32 program are written to 
the output file (MACRO1.MAC). List output is written to the list 
file (PR:). 


The user can now follow the procedures outlined in Chapter 1 for 
expanding the macros, assembling the expanded macros, and linking 
the object module to yield an operating system. 


5202 Creating a Configuration Input File Conversationally and 
Processing the Input File 


The following commands will load and start the Sysgen/32 program 
and allow the user to create a configuration input file in the 
conversational mode and then process the newly created file: 


*LOAD SYSGEN32 

*START, LIST=PR:, COMMAND=CON: 
~SYSGEN/32 ROO0O-00 

YPINPUT=FIGUR2.SYS 

>OUTPUT=MACRO2.MAC <must not exist> 
>CONVERSATIONAL 


At this point a conversational prompt and response’ session 
begins. (Section 5.3 presents a sample conversational prompt 
session.) Each response entered by the user is translated into 
a configuration input statement and then written to the 
designated input file (FIGUR2.SYS). When the prompt session has 
completed, the user processes the input file by entering the 
following commands: 


>PROCESS 


-END OF TASK CODE=0 


on 
i 
NO 
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When the Sysgen/32 program has successfully completed processing 
the configuration input file, the output file contains the macro 
calls generated. The user can now follow the procedures outlined 
in Chapter 1 for expanding the macros, assembling the expanded 
macros, and linking the object module to yield an operating 
system. 


5.2.3 Creating a Configuration Input File Interactively and 
Processing the Input File 


The following commands will load and start the Sysgen/32 program 
and allow the user to create a configuration input file in an 
interactive mode and then process the newly created file: 


*ALLOCATE FIBUR3.SYS,IN,80 

*LOAD SYSGEN/32 

*START, INPUT=FIGUR3.SYS,OUTPUT=MACRO3.MAC,LIST=PR: ,-COMMAND =CON: 
~SYSGEN/32 ROO-00 

>PROCESS 

>READY FOR CONFIGURATION INPUT 

Pe 


At this point the user can interactively enter the required 
sysgen configuration statements. Chapter 2 describes the format 
and content of these sysgen statements. It is important to note 
that the specified input file (FIGUR3.SYS) must be an empty file 
or the interactive prompt will not appear. When the sysgen 
statements have been entered the following commands are entered 
to complete the input file and begin processing: 


>ENDC 
>REALDY FOR SYSGEN COMMANTCS 
>PROCESS 


-~END OF TASK CODE=0 


When the task has reached a successful completion the macro calls 
generated by the Sysgen/32 program are located in the output file 
MACRO3.MAC. The user can now follow the procedures outlined in 
Chapter 1 for expanding the macros, assembling the expanded 
macros, and linking the object module to yield an operating 
system. 
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5.3 CREATING A CONFIGURATION INPUT FILE 

As the examples in the previous sectian show, Sysgen/32 allows 
the user to create a configuration input file in two modes: 

® conversational mode, and 


@e® interactive mode 


For the less experienced user the conversational mode is ideal, 
Since the user merely has to respond to a series of prompts 


supplied by the Sysgen/32 program. The user responses are 
translated to create configuration input statements which are 
written to the configuration input file. This file is then 


processed via the SYSGEN/32 PROCESS command. 


The interactive mode requires more knowledge on the part of the 
user because no SYSGEN/32 prompts are issued. The user enters 
sysgen configuration statements interactively from the command 
device and therefore must know what statements to include and the 
format of each statement. The sections that follow provide 
examples of creating a configuration input file in both 
conversational and interactive modes. 


5.3.1 Using The Conversational Mode 


A conversational prompt and user response session allows the user 
to create a configuration input file from the command device. 
The responses are translated into configuration input statements 
and are written to the specified configuration input file. This 
file is specified with either the INPUT parameter of the START 
command or with the INPUT command. If a user response to. a 
System prompt is not acceptable, the Sysgen/32 program generates 
an error message and continues issuing the prompt until an 
acceptable response is entered. All conversational prompts 
follow this general format: 


QUESTION (POSSIBLE CHOICES) (DEFAULT CONDITION] 


A conversational session does not end until the Sysgen/32 program 
has issued all of the prompts contained in the conversational 
file. When all of the prompts have been displayed, Sysgen/32 
informs the user that the program is ready to accept Sysgen/32 
commandse At this point the user specifies the name of the macro 
output file using the Sysgen/32 OUTPUT= command and then begins 
processing of the configuration input file by entering the 
Sysgen/32 PROCESS command. The Sysgen/32 END command terminates 
the session. A successful completion has been reached if an end 
of task code of 0 is received. The following example is a sample 
conversational sessions: 
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*LOAD SYSGEN32 
*START, INPUT= FIGURE1.SYS, COMMAND=CON: 


~SYSGEN/32 ROO-00 


>CONVERSATIONAL 
PROCESSOR MODEL (7/32, 8/32, 3210, 3220, 3230, 3240, 3250) [3220] 
Se OF REGISTER SETS (2 OR 8) [8] | 
‘is VERSION (8 CHAR. ALPHANUMERIC STRING) (BLANKS) 
>3220.N13 
SIZE OF MEMORY IN KB (64-16384, DIVISIBLE BY 16) (256] 
Axe SYSTEM SPACE IN KB (1 TO TOP OF MEMORY) [25] 
ce NUMBER OF TASKS (1 TO 252) [32] 
a ReROUR MAX. PRIORITY (11 TO 248) [16] 
ST CkeROnMs MAX. SYSTEM SPACE (0.25 KB INCREMENTS) [9] 
° COMMAND BUFFER LENGTH (32 TO 1024 BYTES) [80] 
ee MESSAGE BUFFER LENGTH (32 TO 132 BYTES) [72] 
or LEVELS (1 TO 249) {5) 
Ung: OF QUEUE ENTRIES (10 TO 64999) [TOTAL NUMBER OF DEVICES] 
ie CF JOURNAL ENTRIES (0 TO 12999) [0] 
“mca ADDRESS (300, 500, 900) [X"300"] 


LINE CLOCK FREQUENCY (50 OR 60) [60} 


ENTER STARTUP PROCEDURES (COMMANDS OR CR) [NO STARTUP PROC.) 


>CR 

MEMORY DIAGNOSTIC SUPPCRT (YES OR NO) [NO} 
>yY 

ERROR RECORDING SUPPORT (YES OR NO) [NO] 
>CR ° 

TCOM SUPPORT (YES OR NC) [NO] 
>Y 

ENTER TCOM NAME 

>TCM1 

ENTER START ADDR OF TCOM 
>10000 

ENTER TCCM SIZE (IN 0-25 KB INCREMENTS) 
>e25 


COORDINATION (EDMA) SUFFORT (YES OR NO) [NO] 
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ENTER DEVICES THIS GROUP 


ENTER SELECTOR CHANNELS THIS GROUP 


ENTER TRANSFER RATE 
>1 . 


COORDINATION (EDMA) SUPFORT 


>N 

MCONFIG (YES OR NO) [NO] 
>Y 

BLOCK (0-18) 
20 

START (0-15) 
>0 

RANGE (1-16) 
> 1 

INTERL (€0,2,4 OR CR) 
>CR 


(YES OR NO) [NO] 


SHARED (RECORD,NORECORLT,NVRECORD OR CR) 


>RECORD 


NAME OF CONSOLE DEVICE (CON: ) 


>CR 


NAME OF CONSOLE DEVICE (CON: ) 


TTY/RP MCDEL 33 (CURRENT 
DEVICE NAME [TTY:] 


TTY/RP MODEL 33 (CURRENT 
DEVICE NAME [TTY:] 


DEVICE ADDRESS [002] 
2002 . 

INTERRUPT LEVEL [0] 
20 

IOCLASS [2] 
>2 

TTY/RP MODEL 33 (CURRENT 
DEVICE NAME ([TTY:] 
>TTY2: 

DEVICE ADERESS [002] 
>006 

INTERRUPT LEVEL [0] 
>0 

IOCLASS [2] 


TTY/KP MODEL 35 (CURRENT 
DEVICE NAME [TTY:] 


TTY/RP MODEL 35 (CURRENT 
DEVICE NAME [TTY:] 


LOOP 


LOOP 


LOOP 


LOOP 


LOOP 


INTERFACE),DCOD 


INTERFACE),DCOD 


INTERFACE) ,DCOD 


INTERFACE),DCOD 


INTERFACE),DCOD 


813 


[e3] 
ND 
ae 
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>/ 
NONEDITING CRT (Current LOOP INTERFACE), DCOD18: 
DEVICE NAME [TTY:] 
>/ 
CAROUSEL 15, 30, 35 (80 CHARACTERS, CLI), DCOD21: 
DEVICE NAME [TTY:] 
>/ 


CONVERSATIONAL PROCESSING COMPLETE 
>OUTPUT=MACRO3.MAC 

>PROCESS 

2END 

-END OF TASK CODE=0 


NOTE 


In a conversational session there is no 
default for device names and addresses. 
The user must enter a response to the 
device prompt or the program will 
continue to issue the same device prompt 
until a response is received. A slash 
(/) bypasses a device prompt, indicating 
that the device displayed is not desired 
in the system being configured or that no 
further devices of this type are to be 
configured in the systen. 


Table 5-1 describes the parameters 
involved in device prompts. 
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TABLE 5-1 DEVICE PROMPT PARAMETER DESCRIPTIONS 


woaerwerwr aes SB SFE eB Oe wBeeees were ae FB @BZen Beet @Z eZ =e VEZ FODZeeBZMereewsewe Fe @ee2 wee 2 @ ee we &@ wa = ow 


| PARAMETER | DESCRIPTION 


mw ome eee ee Oe Or ee es cee ee oe ee ee ee om ee ee ee eo Om oe oe Oe =e ow Om ae 9m oe ee oe em we om oe ow ee ow 08 we ee oe om oe oe oe oe ee oe ot ee cs oe oe en ee ee 
ee ee ee ee ee ee ee ee es es le es lr Lr le le lt ll 


DEVICE NAME Four-character mnemonic the system associ- 
ates with a device 


Hexadecimal number specifying the physical 
address of a device 


DEVICE ADDRESS 


Decimal number from 0 (highest) through 
3 (lowest) specifying the hardware 
interrupt level for device interruption 


INTERRUPT LEVEL 


I/O CLASS Decimal number from 0 through 31 speci- 


fying the device or file class 


to and from a terminal 
SELECTOR CHANNEL Two-digit hexadecimal number specifying 
the SELCH address 
CONTROLLER Two-digit hexadecimal number specifying 
the CONTROLLEP address 


Decimal number from 0 through 3 specifying 
the floppy disk spindle number 


SPINDLE NUMBER 


TRANSFER RATE Number of simultaneous transfers if coord- 


ination is specified 


| 
i 
| 
i 
| 
{ 
| 
| 
| 
{ 
| 
| 
CLOCK A, B, C, D }] Baud rate at which data can be transmitted 
| 
| 
| 
| 
{ 
| 
| 
| 
| 
{ 
| 
| 
| 


5e3e1-1 Accessing The HELP File in Conversational Mode 


To access the HELP file during a conversational session, enter a 
question mark (?) in respcnse to a program prompte Information 
pertinent to the last prompt issued will be displayed to the 
command device. 


Example: 


BACKGROUND MAX. SYSTEM SPACE (0.25 KB INCREMENTS) [9] 
>? 
BACKGROUND: ESTABLISHES BACKGROUND PRIORITY AND SYSTEM SPACE 
COMMAND FORMAT: BACKGROUND [MAXPRI] [,MAXSIZE] 
MAXPRI=DECIMAL NUMBER FROM 11 
THROUGH 248 ; 
DEFAULT=16 
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MAXSIZE=CDECIMAL NUMBER, INCREMENTS OF 


0.25 KB 
DEFAYULT=9 
>CR 
BACKGROUND MAX. SYSTEM SPACE (0.25 KB INCREMENTS) [9] 
210 . 


5-3-2 A Configuration Input File Created Interactively 


To create a configuration input file interactively, the user must 
load and start the Sysgen/3zZ program either with the name of an 
interactive device specified as the command device, or by taking 
the default CON: 


The user may use the START command format shown in Example 3 in 
Section 5.2, or the user may specify only the command device in 
the START command and then specify the input and output files 
using the Sysgen/32 commands, as shown in the following example. 


Examples 


*LCAD SYSGEN/32 
*START,CCMMAND=CON: 
-~SYSGEN/32 R00-00 
>INPUT = FIGUR1.SYS < must be an empty file »> 
>OUTPUT= MACRO7.MAC < Must not pre-exist > 
>PROCESS 
READY FCR CONFIGURATION INPUT 
> 


>ENDC 

*READY FOR SYSGCEN/32 COMMANDS 
>PROCESS 

>END 

-END OF TASK CODE=0 


The user enters the sysgen configuration statements after the 
following message appears: 


READY FOR CONFIGURATICN INPUT 


The ENDC command terminates entry of configuration statements and 
returns the user to the Sysgen/32 command mode. The PROCESS 
command initiates processing of the configuration input file. 
When an end of task code of zero is received, the program has 
reached a successful completion. 
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5.3.-2-1 Accessing the HELP File in Interactive Mode 


To access the HELP file while creating a configuration input file 
interactively the user must exit the configuration input mode 
using the ENDC command. The Sysgen/32 HELP command can then be 
used to access the HELP file. When the HELP command is entered 
the following message is displayed: 


FOR A LIST OF COMMANDS TYPE HELP* 
FOR HELP ON ANY COMMAND MNEMONIC, TYPE HELP (MNEMONIC) 


When the HELP command is entered with an asterisk (*) all 
Sysgen/32 commands and configuraticn statements are displayed. 
When the HELP command is entered with mnemonic of a configuration 
statement or Sysgen/32 command, information pertinent to that 
specific mnemonic is displayed. 


Once the user has obtained the desired information from the HELP 
file the Sysgen/32 EDIT command can be used to return to creating 
the configuration input file. Enter EDIT, GET the input 
filename, and position yourself where you left off prior to using 
the HELP command. 


Examples 


*LOAD SYSGEN/32 
*START,COMMAND=CON: 


-SYSGEN/32 RO0O-00 


>INPUT= FIGUR7.SYS < empty input file > 
>OUTPUT= MACRO7.MAC < non existent output file »> 
>PROCESS 


READY FOR CONFIGURATION INPUT 
PVERSION 3220 
2>CPU 3220 
>MEM 1024 
>DSYS 150 
>ENDC 
>READY FCR SYSGEN COMMANDS 
PHELP ACCOUNTING 
ACCOUNTING: INCLUDES ACCOUNTING SUPPORT 


COMMAND FORMAT: ACCOUNTING [ N ] [,NO FILE ACCOUNTING] 


N= Decimal Value From 2 through 32, SPECIFYING THE 
MAXIMUM NUMBER OF ACCOUNTING CLASSES 
DEFAULT FOR N=4 
NO FILE ACCOUNTING SPECIFIES THAT FILE 
ACCOUNTING SUPPORT IS EXCLUDED 
>EDIT 
>READY FCR EDIT COMMANDS 
>GET FIGUR7.SYS 
APPEND BOTTOM 
5 ENDC 
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7 =1 

4 DSYS 150 

7 INS 

4.01 ACCOUNTING 4 


DONE 

>READY FOR SYSGEN COMMANDS 
>PROCESS 

>END 

~END OF TASK CODE=90 


5.3.3 Modifying A Configuration Input File Via EDIT/32 


Regardless of how it was created, a canfiguration input file that 
contains an error or an improperly specified configuration 
statement can be modified using the Sysgen/32 EDIT command. The 
EDIT command invokes EDIT/32 and makes all of the EDIT/32 
commands available to the Sysgen/32 user. After modification, 
the input file may then be processed via the PROCESS command. 


Examples: 


*LOAD SYSGEN32 
*START,-INPUT= FIGUR1-SYS, COMMAND=CONs 


~SYSGEN/32 R00-00 


>ELIT < invokes editor > 
READY FOR FDIT COMMANDS 
>GET FIGUR1.SYS < specifies file to be edited > 
>T 1-4 < displays lines 1-4 > 
1 VERSION 3220 
2 CPU 3220 
3 MEM 1024 
4 DSYS 200 
>CHANGE /200/, /150/,4 < modifies line 4 > 
4 DSYS 150 
>DONE <€ saves file and exits EDIT/32 > 


READY FOR SYSGEN COMMANDS 
D>OUTPUT= MACRO1.MAC 
>PROCESS 
>END 
-~END OF TASK CODE=0 
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| APPENDIX A 
COMPARISON OF SYSGEN/32 AND OS/32 CUP STATEMENT DEFAULTS 


STATEMENT CUP DEFAULT SYSGEN DEFAULT 
ACCCUNTING 4 4 
BACKGROUND PRIO 16 16 
BACKGROUND SIZE 9 9 
CLOCK 60,6C,6D 60,6C,6D 
CMDLEN 80 80 
CPU 71/32 3220 
REGISTERS 2 8 for all but 7/32 
CSs 5 5 
DATE MMDDYY MMDDYY 
DEVADS 0 0 
DIRECTORY CFE OFF 
DISCBLOCK i 4 
DSYS 25 25 
ERRCRREC OFF OFF 
FLOAT (CPU 7/32,8/32) N,N N,N 
FLOAT (P-E 3200 SERIES) H,H H,H 
ILEVEL 0 0 
INTERCEPT OFF OFF 
ITOCLASS 0014243 0,1,2,3 
ITAM OFF OFF 
JOURNAL 0 0 
LOGLEN 72 72 
MAXTASK 32 32 
MCONFIG CFF OFF 
MEMCHECK OFF OFF 
MEMORY 128 256 

LIMITS: 16384 for 3250, 
3240, 

3230 

4096 for 3210 

1024 for 3220, 

71/32, 

8,32 

NOSEG ON ON 
TGD TGD NOTGD 
QUEUE NO. OF DEVICES NO. OF DEVICES 
ROLL OFF OFF 
SPOCL OFF OFF 
SSTABLE 32 32 
TEMP BLANK BLANK 
TGD CN OFF 
VERSION BLANK BLANK 
VOLUME BLANK BLANK 
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APPENDIX B 
SYSGEN/32 MESSAGES 


ADDRESS ERROR address 


Device address exceeds the maximum allowable range set in the 
DEVADS statement. 


COMMAND NOT RECOGNIZED 


An invalid command mnemcnic was entered. 


CONSOLE ERROR 


A console device was not specified, or more than one device 
was specified as a conscle device. 


COORDINATION ERROR name 


Named device not recognized as a valid device. 


DUPLICATE START OPTION: xxx 


Start options were entered more than once, 


ERRCRS IN ASSEMBLY, SYSGEN ABORTED 


Sysgen CSS message indicating that errors were encountered in 
the assembly phase. 


ERRORS IN MACRO EXPANSION, SYSGEN ABORTED 


Sysgen CSS message indicating that errors were encountered in 
the macro expansion phase. 


FILE DESCRIPTOR ERROR 


A device or filename entered ina command was either invalid 
or omitted. 
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INPUT: 
OUTPUT: 

FILE ERROR ON LIST: (Text] 
CONVERSATIONAL: 


Text specifies one of the following: 


ACCOUNT ERROR 
ASSIGNMENT ERROR 
BUFFER ERROR 

FILE DESCRIPTOR ERROR 
I/O ERROR 

ILLEGAL FUNCTION 
INVALID LU 

NAME ERROR 

PRIVILEGE ERROR 
PRCTECT ERROR 

SIZE ERROR 

SVC7 ERROR 

TGD ASSIGNMENT ERROR 
TYPE ERROR 

VOLUME ERROR 


An error was encountered during the allocation or assignment 


of the device or file identified by fd. 


ILEVEL ERROR ilevel 


An invalid ilevel value was issued, or an ilevel other than 


O was specified with only 2 register sets. 


ILLEGAL SEPARATOR: xxx 


A separator was omitted or incorrectly entered. 


ILLEGAL VALUE: XXxXX 


The characters replacing xxxx represent the 


value. 
ADDRESS 
ILLEGAL TCCMs NAME 
SIZE 


TCOM address is not in global memory, TCOMs 


flagged illegal 


overlap, the 


names of two TCOMsS are the game, or the name TSKCOM was 


specified. 
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INPUT FILENAME OMITTED 
Sysgen CSS message indicating the name of the configuration 
input file was not entered as input to the Sysgen/32 CSS 
procedure. 

INPUT FILE filenameeSYS DOES NOT EXIST, SYSGEN ABORTED. 
Sysgen css message indicating that the specified 
configuration input file does not exist. 

INPUT MUST BE ENTERED 
CONVERSATIONAL or PROCESS command was entered before an input 
file was specified. 

INVALID ARGUMENT: argument 
An illegal argument was located while processing the 
configuration input file. 

COMMAND DEVICE ERROR 
Specified device or file is syntactically incorrect or failed 
to assign. 

INVALID COMMAND IN BATCH: CONVERSATIONAL/EDIT 
The EDIT or CONVERSATIONAL command was entered in batch mode. 

LIST DEVICE ERROR 
Specified device or file is syntactically incorrect or failed 


to assign. 


INVALID START OPTION: opticn 


Program does not recognize a START command option. 
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INPUT: 
OUTPUT: 

I/O ERROR ON LIST: text ON fd 
COMMAND: 


text specifies one of the following: 


DEVICE UNAVAILABLE 

END CF FILE 

END OF MEDIUM . 
ILLEGAL OR UNASSIGNED LU 
ILLEGAL FUNCTION 

PARITY OR RECOVERABLE ERROR 
UNRECOVERABLE ERROR 


fd identifies the assigned file or device on which the error 


occurred. 


LINE xxx ADDR xxxxx STACK OVERFLOW 


The program does not have sufficient memory to process the 
input file. Reload the program with a larger segment size 


increment. 


MACRC FILE filename.MAC DCES NOT EXIST, SYSGEN ABORTED 


Sysgen CSS message output in macro expansion phase indicating 
that the filename of the macro output file does not exist. 


MACRO LIBRARY filename.FLB NOT FOUND, SYSGEN 


Sysgen CSS message indicating a required 
not founde 


MAX. NUMBER OF TCOMS FXCEEDED 


Too many TCOMs were specified. 


MISSING ARGUMENT 


A required argument was omitted. 


MODULE NOT INCLUDED: module name 


ABORTED 


macro library was 


The module identified by module name was not included in the 
system. There might be a combination of invalid option 


settings. 
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NO DEVICES 


No devices were specified in the input file. 


NO DIRECT ACCESS SUPPORT 
DIRECTORY, ROLL, SPOCL, TEMP, or VOLUME statements were 
entered, but no disk devices were specified. 

OBJECT LIB filename NOT FOUND, OS LINKING ABORTED 


Sysgen CSS message indicating that a required system or 
driver object library was not found. 


OUTPUT FILE ERROR: xxx 


The output file already exists, or the fd is incorrect. 


OUTPUT MUST BE ENTERED 


The output file was not specified. 


SEQUENCE ERROR 


The statement preceeding the message was entered more than 
once, Or a corresponding required statement was omitted. 


ILEVEL or IOCLASS statement was entered after all devices 
were processed; i.e., after the ENDD statement was read. 
SPECIFIED FILE filename DOES NOT EXIST, LINK OF OS ABORTED 


Sysgen CSS message indicating that a file required in the 
Link procedure cannot be found. 


STATEMENT NOT RECOGNIZED 


A statement in the input file tis not recognized by the 
programe 


 SYSGEN32 ERROR, SYSGEN32 ABORTED 


An error in running the Sysgen/32 program was detected. The 
Sysgen procedure is aborted. 
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xxxx ERROR 


The characters replacing xxxx specify ROLL, SPOOL, TEMP, 
VOLUME, MEMORY, MODULE, FLOAT, ILEVEL, ERROR RECORDING, 
ACCOUNTING, NAME, ADDRESS, DCOD, SELCH, OR COORDINATION. 


Invalid syntax in the vcoclume. 


More than 16 pseudo devices specified (SPOOL), or spool 
support was requested but no pseudo devices were found. 


The memory specified exceeds the allowed range for the 
requested CPU. 


A MODULE statement was entered with a name that could not be 
recognized by the program, or the MODULE name was 
syntactically incorrect. 


Invalid floating point options or combinations were entered. 
No single precision floating point, but hardware double 
precision. Or, for the Perkin-Elmer 3200 series CPUs the 
options were H,S or S,H.e 


SELCH, controller, and connected devices have different 
ILEVELS. 


Syntax error was detected in the name field of a device 
statement, the same name was entered twice, or a blank device 
name was found. 


The device address was invalid, greater than the maximum 
physical address specified, or not zero for spool devices. 
Tevice address was zero, indicating a spool device, but the 
device code was not zero or one. ; 


Specified device code was invalid, not a number from 16 to 
254, or not 0 or 1 for spool devices. 


More than one device specified the same controller with 
different SELCH specifications. . 
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| APPENDIX C 
SYSGEN/32 COMMAND AND STATEMENT SUMMARY 


ACCOUNTING [=] [/»NOFILEACCOUNTING ] 


maxpriority maxsize 
BACKGROUND [=] a , 
50 pic addr lfc addr 
cLock [=] , , [-D] 
60 ec ep 
CMDLEN [=]] _ 
#0 
CONVERSATIONAL 
5, 
SELCH = 
(S1eS20Sn) oLRANSFER=n 
COORDINATION [=] name, ; 
*REVICE = 
(name,,eo-,name, ) 
COPY 
line, 
line, 
ENDCOPY 
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: ani 
pare [=] | 


DEvVaDS § [5] 


DEVICES 

dev name: ,address,dcod [,/CONSOLE,] [-LOCLass=n] [-LLEVEL=n] 
(-SELCH=n] [,CONTROLLER=n] [,NONSHARED] [,SPINDLE=n] 
[-XRCOD=xdcod] [,Fov]  [,QUEUE=name] [,RECLEN=n] [,S1ZE=n] 
[,-TRANSLATE=name] [,REACCONTROL=n] [, WRITECONTROL=n] 


[-RADCOUNT=n] [,LEADCOUNT=n] [, POLLIMIT=n] [DUAL] 
XA 

sce 
XC 
XD 


ENDD 
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DIRECTCRY 


piscsiock [=] 2 | 


ENDC 
ERRORREC [=] fd,size, period 
s,s 


S/H 
Float [=] 
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IOQCLASS 


ITAM 


JOURNAL 


n 
LOCLEN [= 
72 


MAXTASK 


4 


2 
MCONFIG BLOCK=nn,START=xx,RANGE=yy | sareeiafah 
NORECOR D 3 


RECORD 


MEMCHECK 


MODULE 
new module name, 


new module name, 
e 
e 


new module name, 


ENDM 
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NOSEG 


QUTPUT £4 


PAUSE 


PROCESS 


QuEuE [=] ; 


ROLL [=] [rvoin] 


spooL [=] [spvoln] 


START [,INPUT=f£d i] QUTPUT=f£d 2), COMMAND=fd 3] [/ LIST=£4 4] 


STARTUP 


ENDS 

com [=] name,,address,,size, [/.../name,,address,,size, ] 
TEMP EJ (tvoin] 

Tgp 

VERSION [=] [vvvvvvvv_] 


votumE C=]) [voin] 


48-037 FOO ROO 


OOY 00d LEO-8h 


APPENDIX D 


SYSGEN/32 AND OS/32 CUP STATEMENT COMPARISONS 


OS/32 CUP STATEMENTS 


maxpriority z(Maxsize 
BACKGROUND e 
36 3 


| 


SHDLEN aed 


SYSGEN/32 STATEMENTS 


maxpriority maxsize 
BackcrcunD [=] : 
ts & 


CMDLEN [=] | 


| #2 | 
S, 
SELCH = 
(S, 7S20Sn) eLRANSFER=n 
COOPDINATION [=] name, 
/DEVICE = 


COPY 


line, 


line, 


ENCDCOPY 


(name,,ooe,name, ) 
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OS/32 CUP STATEMENTS SYSGEN/32 STATEMENTS 


\ . 
3229 8 
CEU ca cpu [=] 


bevaps [5] ; | 


+ 

ie] 

° OS/32 CUP STATEMENTS SYSGEN/32 STATEMENTS 

WwW 

~ 

re DEVICES DEVICES 

S level C | Saco aeee dev name: ,address,dcod [;CQNSOLE,] [,OCLASS=n] [,ILEVEL=n] 
~ ‘ | Crvedseen scot od Hise (/SELCH=n] [,CONTROLLER=n] [,NONSHARED] [,SPINDLE=n] 

© : 132 


[-kDCOD=xdcod] [,£0V]  [,QUEUE=name] [,RECLEN=n] [,$12E=n] 
feet [-TRANSLATE=name] [[REALCONTROL=n] [,WRITECONTROL=n] 
6 (-Papcount=n] [,LEADCCUNT=n) [,FOLLIMIT=n] [, DUAL] 


| A c)[( xdcod ecl soe 
. Perdrtentot od iia) ‘ 


S 


ENDD 


DIRZECTCRY DIEECTCRY 


n 


DISCBLOCK ca| 


n 
DISCBLOCK 
‘* 


ERRCEPREC [=] fd,size,pericd 


o 
; | 
= | osvaa cue stasemens CUP STATEMENTS SYSGEN/32 STATEMENTS 


s e Ss S F S 
Laie SoH el SH 
OA FLoat [= 
3 
2 
LLEVEL ILEVEL 
1 
0 
NT FRCEPT 
aon 
5 
IGCLASS 1 loctass [=] 
; . 
x 
ITAS ITAM 
n 
JOURNAL JOURNAL [=] | _ 
‘at Bia 


] LOGLEN [=] i 


MAXxTaASK [=] | 


poatse |} 
72 


O04 O04 LEO-8h 


004 O04 LE0-8t 


0S/32 CUP STATEMENTS SYSGEN/32 STATEMENTS 


2 
MCONFIG BLOCK=nn,START=xx,RANGE=yy |. INTER uefa | 


en 
: ,SHARED=4 NYRECORD 
(areas 
MEMCHECK MEMCHECK 
n 
KEMCRY MEMORY [=}} 
128 . 256 
MODULE MOLULE 
new module name, ioe module name, | 
[new module naney| new module name, 
. module name, new module name, 
ENDA FNEF 
NOSEG NOS EG 
KOTCD 
( 2 
QUEUE queue E}] 
total neaber of devices 
ROLL [rvoln] . ROLL [=] [rvoin] 
SEOCL [spvolr] spoct [=] [spvoln] 


SSTABLF i 1 SSTABLF ca” 
32 32 


3-d 
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OS/32 CUP STATEMENTS 


STARTUP 


ENTS 
TccK name, ,address,,size, [/.../name,,address,,size, | 


TExF tvoln 


VERSICN vvvvvvvv 


VOLUME voln 


SYSGEN/32 STATEMENTS 


TcOoM [=] name, ,address,,size, [/.../name,,address,,size, ] 
TEMP [=] [tvoin] 

TGD 

version [=] [vvvvvvvv] 


votusE (C=) [voin] 
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